Creare un file ZIP a livello di codice in .NET

Aspose.ZIP per .NET consente a un’applicazione C# di creare un nuovo archivio ZIP senza avviare 7-Zip, WinRAR o altre utility desktop. Crea un’istanza di Archive, aggiungi i file sorgente come voci con un nome preciso e chiama Save per scrivere l’archivio su file o stream.

Questa pagina riguarda la creazione del contenitore ZIP e l’organizzazione del suo contenuto. La compressione è una parte del processo, ma il risultato principale è un nuovo archivio che può contenere un singolo file, più file o un intero albero di directory.

Esempio C#: creare un archivio ZIP con più file

L’esempio crea package.zip, aggiunge un PDF e un file CSV e assegna un nome chiaro a ogni voce.

Crea package.zip e aggiungi due file

using Aspose.Zip;

using (var archive = new Archive())
{
    archive.CreateEntry("report.pdf", "report.pdf");
    archive.CreateEntry("data.csv", "data.csv");
    archive.Save("package.zip");
}

Installare Aspose.ZIP per .NET

Installa il pacchetto NuGet Aspose.ZIP e aggiungilo come riferimento al progetto .NET. L’archivio viene creato nel processo dell’applicazione e non richiede un programma ZIP separato.

Console di Gestione pacchetti

PM> Install-Package Aspose.Zip

Creare uno ZIP da un solo file

Crea un’istanza di Archive, chiama CreateEntry indicando nome della voce e percorso sorgente, quindi salva l’archivio. È un flusso adatto a report, esportazioni e documenti generati.

Aggiungere più file

Chiama CreateEntry per ogni sorgente prima del salvataggio. Il nome della voce è indipendente dal percorso locale, quindi puoi organizzare in modo coerente file provenienti da cartelle diverse.

Creare uno ZIP da una cartella

Aggiungi i file presenti sotto una directory conservando percorsi relativi sicuri. In questo modo lo ZIP contiene un albero portabile e non espone percorsi assoluti della macchina.

Scrivere lo ZIP in uno stream

Salva l’archivio in uno stream scrivibile per restituirlo da ASP.NET, caricarlo nello storage cloud o mantenere l’intero flusso in memoria senza creare un file temporaneo.

Come funziona la creazione di archivi ZIP in C#

  1. Installa Aspose.ZIP per .NET e aggiungi il riferimento al progetto.
  2. Crea un’istanza di Archive per il nuovo contenitore ZIP.
  3. Aggiungi ogni sorgente con CreateEntry oppure inserisci il contenuto di una directory.
  4. Configura compressione e crittografia se richieste.
  5. Salva l’archivio in un percorso o in uno stream scrivibile.
  6. Rilascia l’archivio e gli stream aperti dall’applicazione.

Aggiungi tutte le voci prima di salvare, così la directory centrale descriverà correttamente il contenuto del file ZIP.

Controllare nomi e cartelle all’interno dello ZIP

Il **percorso sorgente** indica dove leggere il file; il **nome della voce** stabilisce come verrà visualizzato nello ZIP. Tenere separati i due valori permette di rinominare le voci, raggrupparle in cartelle virtuali e non divulgare directory locali.

Usa barre oblique per percorsi come documents/2026/report.pdf. Rifiuta percorsi assoluti, segmenti ../, nomi vuoti e duplicati non intenzionali quando i valori provengono da utenti o sistemi esterni.

Creare un archivio ZIP protetto da password

Aspose.ZIP supporta ZipCrypto tradizionale e la crittografia AES con chiavi da 128, 192 o 256 bit. Preferisci AES quando il software del destinatario lo supporta; usa ZipCrypto solo se è indispensabile la compatibilità con strumenti meno recenti.

Tratta le password come segreti: recuperale da una configurazione sicura, non scriverle nel codice o nei log e comunicale attraverso un canale separato dall’archivio.

Scegliere il metodo di compressione delle voci ZIP

Deflate è la scelta pratica per archivi ZIP ampiamente compatibili. In base ai dati e al software di destinazione puoi usare anche BZip2, LZMA, PPMd oppure la modalità Store senza compressione.

JPEG, MP4 e molti documenti Office sono già compressi e possono ridursi poco. Lo ZIP resta utile per riunirli in un solo file con nomi, cartelle e protezione coerenti.

Creare uno ZIP oppure comprimere, estrarre o visualizzare

ObiettivoFlusso da usareRisultato
Creare un nuovo ZIP e aggiungere file o cartelleCrea ZIP — questa paginaUn nuovo ZIP con le voci selezionate
Ridurre le dimensioni o creare un altro tipo di archivioComprimere file in C#Dati compressi o un contenitore differente
Ripristinare file da un archivio esistenteEstrarre archivi in C#File originali scritti in un percorso o stream
Esaminare le voci senza estrarleVisualizzare il contenuto in C#Elenco dei nomi e dei metadati disponibili
Aggiungere o modificare la protezioneProteggere archivi con password in C#Un archivio cifrato che richiede credenziali valide

Aggiungere un PDF, DOCX, PNG o un altro file allo ZIP non ne converte il formato interno: il file originale diventa una voce del nuovo archivio.

Indicazioni per creare file ZIP in produzione

- Rilascia archivi e stream in modo deterministico. - Usa uno stream per risposte ASP.NET e caricamenti nello storage cloud. - Convalida percorsi, nomi delle voci, numero di file e dimensione totale per le richieste non attendibili. - Scrivi prima in una destinazione temporanea se un output parziale potrebbe essere dannoso. - Non sovrascrivere archivi esistenti senza un’autorizzazione esplicita dell’applicazione. - Normalizza ordine, nomi e timestamp quando serve un output ZIP riproducibile.

Creare archivi ZIP dai tipi di file più comuni

Consulta le guide specifiche per il formato usato dalla tua applicazione. La sorgente resta invariata all’interno dello ZIP; ogni guida spiega come organizzare il pacchetto e le relative risorse.

Creare file ZIP online

Ti serve uno ZIP senza scrivere codice? Usa gratuitamente il creatore di file ZIP online dal browser.

  Non occorre installare software desktop.
  Non sono richiesti codice o configurazione API.
  Carica uno o più file sorgente.
  Scarica l’archivio ZIP generato.

Risorse per Aspose.ZIP per .NET

Domande frequenti

1. Come si crea un file ZIP in C#?

Crea un’istanza di Archive, aggiungi una sorgente con CreateEntry e chiama Save indicando il percorso o lo stream di output.

2. Posso aggiungere più file allo stesso archivio ZIP?

Sì. Chiama CreateEntry per ogni file e salva l’archivio dopo aver aggiunto tutte le voci.

3. Posso creare uno ZIP da un’intera cartella?

Sì. Aggiungi i file della cartella usando nomi relativi sicuri per conservare la struttura richiesta.

4. Posso creare uno ZIP cifrato con AES in .NET?

Sì. Configura AES-128, AES-192 o AES-256 e recupera la password da una configurazione sicura.

5. La creazione dello ZIP richiede 7-Zip o WinRAR?

No. Aspose.ZIP crea l’archivio direttamente nell’applicazione .NET senza invocare software esterno.