Como criar um arquivo ZIP com arquivos CSV no .NET

Com o Aspose.ZIP for .NET, uma aplicação C# pode criar um arquivo ZIP com arquivos CSV sem iniciar o 7-Zip, o WinRAR ou outro compactador instalado. Crie uma instância de Archive, adicione cada arquivo como entrada, inclua os recursos necessários e chame Save para gerar o ZIP final.

A API empacota somente os arquivos indicados e não altera itens como células, fórmulas, formatação, macros e dados internos da pasta de trabalho. Assim, é possível entregar um arquivo de planilha e seus materiais complementares como um único pacote portátil, mantendo os dados de origem intactos.

Exemplo em C#: compactar um arquivo CSV em ZIP

Este exemplo conciso adiciona um arquivo CSV a um novo arquivo ZIP e salva o resultado como archived_result.zip. Defina dir como o diretório que contém o arquivo de origem.

Compactar arquivos CSV — C#

var dir = "full directory path";
using (var arch = new Archive())
{
   arch.CreateEntry("filename.csv", dir+"file.csv");
   arch.Save(dir+"archived_result.zip");
}

Instalar o Aspose.ZIP for .NET

Instale o pacote NuGet Aspose.ZIP e adicione a referência ao projeto .NET. A criação do ZIP ocorre dentro do processo da aplicação e não exige um utilitário instalado separadamente.

Console do Gerenciador de Pacotes

PM> Install-Package Aspose.Zip

Arquivar um arquivo CSV

Adicione um arquivo de origem no formato CSV a uma nova instância de Archive e salve o resultado. Use um nome de entrada claro quando o ZIP disponibilizado precisar apresentar um nome mais simples ou padronizado.

Empacotar vários arquivos CSV

Chame CreateEntry para cada arquivo CSV antes de salvar. Arquivos provenientes de diretórios diferentes podem ser organizados em uma única pasta spreadsheets/ dentro do ZIP.

Empacotar arquivos CSV com recursos relacionados

Adicione os arquivos CSV juntamente com recursos como fontes de dados externas, documentação, exportações e relatórios de validação. Preserve os caminhos relativos esperados pelo fluxo de trabalho de destino para que o pacote possa ser usado depois da extração.

Salvar ou transmitir o pacote CSV

Salve o ZIP concluído em um arquivo local, grave-o em uma resposta ASP.NET ou envie-o diretamente para o armazenamento em nuvem por meio de um stream gravável. A estrutura e os nomes das entradas permanecem iguais em qualquer destino.

Como criar um arquivo ZIP a partir de arquivos CSV em C#

  1. Instale o Aspose.ZIP for .NET e adicione a referência ao pacote.
  2. Identifique os arquivos CSV e todos os recursos que devem integrar o pacote.
  3. Crie uma instância de Archive para o novo contêiner ZIP.
  4. Chame CreateEntry para cada arquivo de origem e atribua o caminho desejado dentro do arquivo ZIP.
  5. Configure a compactação ou a criptografia quando o processo de entrega exigir.
  6. Chame Save com um caminho de saída ou stream gravável e, em seguida, libere corretamente os recursos.

Adicione todas as entradas planejadas antes de salvar. CreateEntries pode incluir recursivamente uma árvore de diretórios preparada; chamadas individuais de CreateEntry oferecem maior controle sobre nomes e arquivos selecionados.

Criar um ZIP não converte o formato CSV

Criar um arquivo ZIP com arquivos CSV é uma operação de arquivamento, não uma conversão. O arquivo `.csv` continua no formato CSV dentro do contêiner, e a extração restaura os mesmos bytes. O Aspose.ZIP não interpreta nem reescreve células, fórmulas, formatação, macros e dados internos da pasta de trabalho.

Quando o objetivo for converter arquivos CSV para XLSX ou ODS, use uma biblioteca de conversão específica. Use esta operação de arquivamento para agrupar, transferir, armazenar ou proteger os arquivos existentes.

Incluir arquivos relacionados ao formato CSV

Um pacote CSV completo pode conter, além do arquivo principal, fontes de dados externas, documentação, exportações e relatórios de validação. O Aspose.ZIP trata cada item como uma entrada independente e não analisa o arquivo CSV para descobrir dependências automaticamente. A aplicação deve determinar quais recursos pertencem ao pacote e adicioná-los de forma explícita.

Inclua fontes de dados externas e documentação somente quando forem necessárias para o destinatário usar o pacote. Antes de criar o ZIP, confirme que todos os componentes necessários estão disponíveis e preserve a organização relativa esperada pelo software de destino.

Controlar caminhos e nomes no ZIP que contém arquivos CSV

O caminho de origem informa ao .NET onde ler o arquivo; o nome da entrada determina onde ele aparece no ZIP. Dessa forma, um arquivo local de qualquer diretório de trabalho pode ser armazenado como `spreadsheets/arquivo.csv` sem expor o caminho local.

Use barras (/) nos caminhos portáteis do ZIP, mantenha o uso de maiúsculas e minúsculas consistente e rejeite caminhos absolutos ou segmentos que apontem para o diretório pai, como ../. Verifique também nomes de entrada duplicados quando os arquivos vierem de diretórios diferentes. Uma estrutura clara geralmente contém uma pasta para o conteúdo principal, outra para recursos complementares e um README.txt na raiz.

Compactação esperada para arquivos CSV

Pastas de trabalho baseadas em XML geralmente já são compactadas, enquanto dados tabulares em texto podem diminuir bastante. Mesmo quando a economia de bytes é pequena, o ZIP ainda fornece um único arquivo transferível, uma estrutura de diretórios definida, informações de integridade e proteção opcional por senha.

O Deflate é a escolha padrão mais prática para ampla compatibilidade. O modo de armazenamento sem compactação pode ser adequado quando a velocidade de empacotamento é mais importante que o tamanho e a maioria das entradas já está compactada. Meça pacotes representativos em vez de presumir a mesma taxa de compactação para todos os arquivos CSV.

Proteger um ZIP com arquivos CSV usando senha

Entradas confidenciais podem ser protegidas com ZipCrypto tradicional ou criptografia AES. Prefira AES quando o software dos destinatários oferecer suporte; use ZipCrypto somente quando a compatibilidade com ferramentas antigas for a prioridade.

Obtenha as senhas de uma configuração segura e nunca as grave no código-fonte nem em logs. Compartilhe a senha por um canal diferente do arquivo ZIP e confirme antes da distribuição que o destinatário consegue abrir o método de criptografia escolhido.

Recomendações de produção para arquivos ZIP com CSV

- Confirme que todos os arquivos de origem e recursos obrigatórios existem antes de gravar o ZIP. - Para solicitações não confiáveis, limite a quantidade de arquivos, o tamanho individual, o volume total de entrada e os locais de origem permitidos. - Normalize e valide os nomes das entradas para impedir caminhos inseguros durante uma extração posterior. - Quando uma saída parcial puder causar problemas, grave primeiro em um destino temporário e publique o arquivo somente depois que `Save` for concluído. - Use um stream gravável ao retornar o ZIP por ASP.NET ou enviá-lo diretamente para armazenamento de objetos. - Libere explicitamente os objetos Archive e os streams; registre dependências ausentes sem expor informações confidenciais ou caminhos locais. - Defina uma ordem estável para as entradas e os carimbos de data e hora quando o processo exigir arquivos ZIP reproduzíveis.

Criar um ZIP com arquivos CSV online

Precisa de um pacote sem escrever código? Use o criador de ZIP online gratuito no navegador.

  Não é necessário instalar um compactador no computador.
  Não é necessário configurar uma API nem escrever código C#.
  Envie os arquivos CSV e os recursos relacionados.
  Baixe o arquivo ZIP gerado.

Recursos do Aspose.ZIP for .NET

Perguntas frequentes

1. Como criar um arquivo ZIP a partir de um arquivo CSV em C#?

Crie uma instância de Archive, chame CreateEntry com o nome da entrada e o caminho do arquivo CSV e, depois, chame Save com o caminho ou stream de destino.

2. Posso adicionar vários arquivos CSV ao mesmo arquivo ZIP?

Sim. Chame CreateEntry para cada arquivo antes de salvar e forneça um nome de entrada exclusivo para cada item.

3. Os arquivos relacionados são adicionados automaticamente?

Não. O Aspose.ZIP empacota os arquivos informados pela aplicação, mas não analisa CSV para descobrir dependências. Adicione explicitamente cada recurso necessário.

4. Criar o ZIP converte CSV para outro formato?

Não. O arquivo CSV permanece inalterado dentro do ZIP. A conversão para XLSX ou ODS é uma operação separada.

5. É possível criptografar um ZIP que contém arquivos CSV?

Sim. O Aspose.ZIP oferece proteção por senha com ZipCrypto e AES. Escolha um método compatível com o software usado pelos destinatários para extrair o arquivo.