- 使用 C# 的 Outlook 註解便條庫
- 創建新的註解便條
- 將新的註解便條添加到 PST
- 從 PST 文件檢索 Outlook 註解便條
- 如何在 Exchange 服務器上創建新的 Outlook 註解
- 從 Exchange 服務器提取便條
Outlook 註解便條為用戶提供了一種方便的方式，可以在其郵箱中創建快速、可訪問的提醒。這些提醒存儲在 PST 文件中，與電子郵件、聯繫人、日曆事件和其他 Outlook 項目一起管理。對於以編程方式處理 Microsoft Outlook 數據的開發人員來說，訪問、創建或管理註解便條對於自動化工作流程或構建增強生產力的應用程序至關重要。
在本文中，我們將探討如何使用 .NET 庫在 C# 中與 Outlook 註解便條一起工作。本指南將涵蓋在 PST 文件中加載和訪問提醒、檢索內容、創建新便條，甚至在 Exchange 服務器上管理它們。通過利用這些功能，開發人員可以以編程方式處理註解便條，促進集成、備份或自定義管理解決方案。
使用 C# 的 Outlook 註解便條庫
要在 C# 中創建和管理 Outlook 註解便條，我們將使用 Aspose.Email for .NET 庫，該庫提供強大的 API 用於處理各種電子郵件和消息相關的功能，包括註解便條。該庫支持在 PST 文件中添加、閱讀、更新和刪除它們，非常適合用於處理 Outlook 數據。
安裝
您可以通過 Visual Studio 中的 NuGet 包管理器或使用 NuGet 包管理器控制台安裝 Aspose.Email for .NET。以下是兩種方法：
- 在 Visual Studio 中使用 NuGet 包管理器：
- 在 Visual Studio 中打開您的項目。
- 轉到 工具 > NuGet 包管理器 > 管理解決方案的 NuGet 包。
- 在瀏覽選項卡中搜索 Aspose.Email。
- 選擇 Aspose.Email 包 並點擊 安裝。
- 使用 NuGet 包管理器控制台：
- 通過導航到 工具 > NuGet 包管理器 > 包管理器控制台 打開 包管理器控制台。
- 運行以下命令以安裝 Aspose.Email for .NET：
Install-Package Aspose.Email
或者，您也可以直接從 Aspose 網站 下載最新版本的 API。
安裝庫後，您將準備好在 C# 項目中開始使用 Outlook 註解便條。Aspose.Email API 使與 Outlook 數據的交互變得簡單，確保您可以高效地在 .NET 應用程序中處理它。
創建新的註解便條
.NET 中的 MapiNote 類使您能夠創建具有可自定義屬性的新註解便條，例如顏色、主題和正文。一旦配置好，便條可以保存為獨立的 .msg 文件，以便在 Outlook 或其他兼容應用中進一步使用。
以下示例演示了如何創建新的註解便條並將其保存為 .msg 文件：
- 實例化一個 MapiNote 對象，並設置其屬性，包括
Color、Subject和Body，以定義便條的外觀和內容。 - 使用 Save 方法，指定文件名和格式（
NoteSaveFormat.Msg），將便條保存為獨立的.msg文件。
通過這種方式，您可以輕鬆創建和分發註解便條作為 .msg 文件，提供一種靈活的方式來在 PST 文件之外管理它們。
將新的註解便條添加到 PST
要將新的註解便條添加到 PST 文件，您可以創建一個 MapiNote 對象並將其保存在 PST 的 “Notes” 文件夾中。此過程涉及加載 PST 文件、訪問適當的文件夾、創建提醒，然後將其添加到該文件夾。以下是逐步指南以及演示如何實現此操作的代碼示例：
- 使用 PersonalStorage.FromFile 方法加載 PST 文件。
- 訪問 PST 中的 “Notes” 文件夾。
- 使用所需屬性（例如顏色、主題和正文）創建 MapiNote 類的新實例。
- 使用 AddMapiMessageItem 方法將註解便條添加到該文件夾。
從 PST 文件檢索 Outlook 註解便條
要從 PST 文件檢索註解便條，您需要訪問 Notes 文件夾並遍歷其內容。以下示例演示了如何加載 PST 文件、訪問目標文件夾並提取其中的便條：
- 使用 PersonalStorage.FromFile 方法加載指定的 PST 文件。
- 使用 GetSubFolder(“Notes”) 從 PST 的根文件夾檢索 Notes 文件夾。
- 在該文件夾上調用 EnumerateMapiMessages 方法並返回所有 MAPI 消息。該代碼過濾這些消息以僅包含
MapiNote對象。 - 顯示每個提取的便條的詳細信息，包括其主題、顏色、高度、寬度和正文，並將它們打印到控制台。
如何在 Exchange 服務器上創建新的 Outlook 註解
要在 Exchange 服務器上創建新的註解便條，您可以利用 EWSClient 與服務器的郵箱進行交互。此過程涉及建立與 Exchange 服務器的連接、創建新的 MapiNote 對象，然後將其保存到 Notes 文件夾。以下是逐步指南以及演示如何實現此操作的代碼示例：
- 首先，您需要使用 EWSClient 類建立與 Exchange 服務器的連接。這需要服務器 URL 和相應的身份驗證憑據。
- 創建一個新的 MapiNote 實例並設置其屬性，例如顏色、主題和正文。
- 使用 CreateItem 方法將新的便條保存到 Exchange 郵箱的指定文件夾中。
以下是演示如何在 Exchange 服務器上創建並保存新的註解便條的代碼示例：
通過遵循此過程，您可以直接在 Exchange 服務器上創建註解便條。
從 Exchange 服務器提取便條
該過程包括對 Exchange 服務器進行身份驗證、列出可用的便條，然後提取每個便條的詳細信息。以下是如何完成這一點：
- 首先，您需要使用自己的 Exchange 服務器憑據創建一個 EWSClient 實例。
- 使用 ListMessages 方法獲取 Notes 文件夾中的消息列表。
- 對於每個便條，使用 FetchMapiNotes 方法檢索其詳細信息。
以下是說明這些步驟的代碼示例：
將 your-email@example.com 和 your-access-token 替換為您的實際 Exchange 郵箱和 OAuth 訪問令牌。
這種方法使您能夠高效地管理和訪問存儲在 Exchange 服務器上的註解便條。
結論
使用 C# .NET 管理 Outlook 註解便條提供了一種組織和檢索工作區中重要信息的方法。通過利用 MAPI 協議的能力，開發人員可以創建、閱讀和更新註解便條，無論是存儲在本地 PST 文件中還是在 Exchange 服務器上。
通過概述的方法，用戶可以通過以編程方式管理數據來提高生產力，讓其與其他應用程序和工作流程更好地集成。無論是創建新的便條以進行快速提醒，還是檢索現有便條以供參考，提供的工具都促進了有效的信息管理。
免費資源
除了其進步的 C# 電子郵件 API，該庫還提供了一些免費資源：
評估 Aspose.Email
您可以免費試用 Aspose.Email 的所有功能，使用其 評估版本。
獲取臨時許可證
如果您希望在沒有評估版本限制的情況下測試 Aspose.Email，您還可以請求 30 天的 臨時許可證。免費試用將使您對服務的能力有一個良好的了解，並讓您進行一些早期開發。