Zimbra TGZ 備份可以容納數千封訊息、聯絡人、約會和任務。
在匯出或遷移之前,了解其內容會很有幫助。
在本文中,您將學習如何在 C# 中計算 TGZ 檔案中的訊息數量。
Aspose.Email for .NET 讓您可以直接詢問 TGZ 備份中每種類型的項目數量,無需匯出步驟。

本教程針對使用 Zimbra 備份的 .NET 開發人員,例如在郵箱遷移工具或備份檢查中。您將計算訊息和聯絡人,然後將範例擴展到每種項目類型。

為什麼要在 TGZ 檔案中計算訊息

計數可讓您在對存檔執行任何高成本操作之前快速檢視其內容。您可以將其用於:

  • 確認 Zimbra 匯出已完成且不為空,然後再開始長時間的遷移。
  • 比較遷移前後的訊息數量。
  • 在匯出封存時於進度條中顯示實際總數。

安裝 Aspose.Email for .NET

安裝 Aspose.Email for .NET 26.9 或更高版本,從 NuGet:

Install-Package Aspose.Email

您還需要一個 Zimbra TGZ 備份。示例使用名為 xhy.tgz 的檔案。

計算訊息與聯絡人

使用 TgzReader 打開備份,然後查詢您關心的每種類型的項目數量。將讀取器包裹在 using 區塊中,以便在完成後釋放檔案。

using System;
using Aspose.Email.Storage.Zimbra;

class Program
{
    static void Main()
    {
        var fileName = "xhy.tgz";
        using (var reader = new TgzReader(fileName))
        {
            int numberOfMessages = reader.GetItemsCount(ItemType.Message);
            int numberOfContacts = reader.GetItemsCount(ItemType.Contact);

Console.WriteLine($"Messages: {numberOfMessages}");
            Console.WriteLine($"Contacts: {numberOfContacts}");
        }
    }
}

程式會印出兩行:備份中的電子郵件訊息數量以及聯絡人數量。

每次計數都是一次單獨的呼叫。您告訴讀取器您想要哪種類型的項目,它會返回一個整數。您無需自行解壓縮檔案或遍歷其內容。

計算每個項目類型

Zimbra 備份可以包含四種項目:訊息、聯絡人、行事曆項目和任務。若要獲得完整的細目,請分別查詢每一項。您也可以取得存檔中項目的總數。

using (var reader = new TgzReader("xhy.tgz"))
{
    Console.WriteLine($"Messages:       {reader.GetItemsCount(ItemType.Message)}");
    Console.WriteLine($"Contacts:       {reader.GetItemsCount(ItemType.Contact)}");
    Console.WriteLine($"Calendar items: {reader.GetItemsCount(ItemType.Calendar)}");
    Console.WriteLine($"Tasks:          {reader.GetItemsCount(ItemType.Task)}");
    Console.WriteLine($"Total items:    {reader.GetTotalItemsCount()}");
}

這會為您提供備份的簡短摘要,您可以將其記錄下來或顯示給使用者。

保持您的應用程式的響應性

這些計數呼叫會等到壓縮檔案被讀取完畢。在控制台工具或腳本中,這通常沒問題。但在桌面應用程式或 Web 請求中,較大的壓縮檔案可能會導致應用程式等待。

如果您需要在桌面應用程式或 Web 服務中計算項目數量而不讓它等待,請參閱 在 C# 中非同步計算 Zimbra TGZ 備份項目數量。

下一步

一旦您了解備份包含的內容,就可以匯出它或逐封讀取其中的訊息。使用 Zimbra 文件同時涵蓋這兩種情況,而 TgzReader API 參考文件 列出了讀取器能執行的所有操作。如果有任何問題,請在 Aspose.Email 支援論壇 提問。

常見問題

  1. 我可以計算哪種類型的 TGZ 檔案? Zimbra 使用 TGZ 檔案匯出郵箱資料。Aspose.Email 讀取這些備份。

  2. 我需要在計數之前匯出壓縮檔嗎? 不需要。您直接打開壓縮檔並請求計數。沒有任何內容會匯出到磁碟。

  3. 我可以計算哪些項目類型? 訊息、聯絡人、行事曆項目和任務。

  4. 我可以一次呼叫取得項目的總數嗎? 是的。TgzReader 也會返回存檔中項目的總數。

  5. 是否有不會阻塞我的應用程式的版本?
    是的。Release 26.9 也新增了計數方法的非同步版本,支援取消。

  6. 我需要處置讀取器嗎? 是的。使用 using 區塊,以便在完成時釋放壓縮檔案。

取得免費授權並探索更多

請求一個免費臨時授權以測試 Aspose.Email for .NET,且不受評估限制。

另請參閱