Um backup Zimbra TGZ pode conter milhares de mensagens, contatos, compromissos e tarefas. Antes de exportar ou migrar um, é útil saber o que está dentro. Neste artigo, você aprenderá como contar mensagens em arquivos TGZ em C#. Aspose.Email for .NET permite que você pergunte a um backup TGZ quantos itens de cada tipo ele contém, sem necessidade de exportação.

Este tutorial é para desenvolvedores .NET que trabalham com backups do Zimbra, por exemplo em uma ferramenta de migração de caixas de correio ou em uma verificação de backup. Você contará mensagens e contatos e, em seguida, expandirá o exemplo para cada tipo de item.

Por que contar mensagens em arquivos TGZ

Uma contagem fornece uma visão rápida de um arquivo antes de você fazer algo caro com ele. Você pode usá‑la para:

  • Confirme que a exportação do Zimbra foi concluída e não está vazia antes de iniciar uma migração longa.
  • Compare o número de mensagens antes e depois de uma migração.
  • Exiba totais reais em uma barra de progresso enquanto exporta o arquivo.

Instalar Aspose.Email for .NET

Instale Aspose.Email for .NET 26.9 ou posterior a partir do NuGet:

Install-Package Aspose.Email

Você também precisa de um backup TGZ do Zimbra. Os exemplos usam um arquivo chamado xhy.tgz.

Contar mensagens e contatos

Abra o backup com TgzReader, então solicite o número de itens de cada tipo que lhe interessa. Envolva o leitor em um bloco using para que o arquivo seja liberado quando você terminar.

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}");
        }
    }
}

O programa imprime duas linhas: o número de mensagens de e‑mail no backup e o número de contatos.

Cada contagem é uma única chamada. Você informa ao leitor qual tipo de item deseja, e ele retorna um número inteiro. Você não precisa extrair o arquivo ou percorrer seu conteúdo manualmente.

Contar cada tipo de item

Um backup do Zimbra pode conter quatro tipos de itens: mensagens, contatos, itens de calendário e tarefas. Para obter uma análise completa, solicite cada um. Você também pode obter o número total de itens no arquivo.

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()}");
}

Isso fornece um resumo curto do backup que você pode registrar ou exibir ao usuário.

Mantenha seu aplicativo responsivo

Essas chamadas de contagem aguardam até que o arquivo seja lido. Em uma ferramenta de console ou em um script, isso geralmente é aceitável. Em um aplicativo desktop ou em uma solicitação web, um arquivo grande pode fazer o aplicativo aguardar.

Se você precisar contar itens em um aplicativo desktop ou em um serviço web sem fazê‑los esperar, veja Contar itens em backups TGZ do Zimbra de forma assíncrona em C#.

Próximos passos

Depois de saber o que o backup contém, você pode exportá‑lo ou ler suas mensagens uma a uma. A documentação Working with Zimbra cobre ambos, e a TgzReader API reference lista tudo o que o leitor pode fazer. Se você tiver dúvidas, pergunte no Aspose.Email support forum.

Perguntas Frequentes

  1. Que tipo de arquivo TGZ posso contar? Zimbra usa arquivos TGZ para exportar dados de caixa de correio. Aspose.Email lê esses backups.

  2. Preciso exportar o arquivo antes de contar? Não. Você abre o arquivo e solicita a contagem diretamente. Nada é exportado para o disco.

  3. Quais tipos de itens posso contar? Mensagens, contatos, itens de calendário e tarefas.

  4. Posso obter o número total de itens em uma única chamada? Sim. TgzReader também retorna a contagem total de itens no arquivo.

  5. Existe uma versão que não bloqueie minha aplicação? Sim. A versão 26.9 também adiciona versões assíncronas dos métodos de contagem, com suporte a cancelamento.

  6. Preciso descartar o leitor? Sim. Use um bloco using para que o arquivo de arquivo seja liberado quando terminar.

Obtenha uma Licença Gratuita e Explore Mais

Solicite uma licença temporária gratuita para testar Aspose.Email for .NET sem restrições de avaliação.

Veja Também