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#
- Instale o Aspose.ZIP for .NET e adicione a referência ao pacote.
- Identifique os arquivos CSV e todos os recursos que devem integrar o pacote.
- Crie uma instância de
Archivepara o novo contêiner ZIP. - Chame
CreateEntrypara cada arquivo de origem e atribua o caminho desejado dentro do arquivo ZIP. - Configure a compactação ou a criptografia quando o processo de entrega exigir.
- Chame
Savecom 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 objetosArchive 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.
Criar arquivos ZIP a partir de outros tipos de arquivo
Empacote documentos, imagens, modelos 3D, mídia e outros arquivos de origem usando C# e .NET.
Recursos do Aspose.ZIP for .NET
- Visão geral do produto
- Documentação para desenvolvedores
- Referência da API
Archive - Referência da API
CreateEntry - Referência da API
CreateEntries - Exemplos em C# no GitHub
- Pacote Aspose.ZIP no NuGet
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.