ZIP-Dateien programmgesteuert mit .NET erstellen

Mit Aspose.ZIP for .NET erstellen Sie in C# neue ZIP-Archive, ohne 7-Zip, WinRAR oder ein anderes externes Programm aufzurufen. Legen Sie eine Instanz von Archive an, fügen Sie Quelldateien unter den gewünschten Eintragsnamen hinzu und speichern Sie das fertige Archiv mit Save in eine Datei oder einen Stream.

Diese Seite behandelt das Erstellen eines ZIP-Archivs und das Zusammenstellen seiner Inhalte. Die Komprimierung ist Teil dieses Vorgangs. Das eigentliche Ergebnis ist jedoch ein geordnetes Archiv, das eine einzelne Datei, mehrere Dateien oder einen vollständigen Verzeichnisbaum enthalten kann.

C#-Beispiel: Ein Archiv mit mehreren Dateien

Das folgende Beispiel erstellt package.zip und fügt eine PDF- sowie eine CSV-Datei hinzu. Für jede Datei wird der Name festgelegt, unter dem sie im Archiv erscheint.

package.zip mit zwei Dateien erstellen

using Aspose.Zip;

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

Aspose.ZIP for .NET installieren

Installieren Sie das NuGet-Paket Aspose.ZIP und binden Sie es in Ihr .NET-Projekt ein. Die Archivierung läuft im Prozess Ihrer Anwendung; ein separates ZIP-Programm ist nicht erforderlich.

Paket-Manager-Konsole

PM> Install-Package Aspose.Zip

Eine einzelne Datei packen

Erstellen Sie ein Archive, rufen Sie CreateEntry mit Eintragsname und Quellpfad auf und speichern Sie das Ergebnis. So lassen sich Berichte, Exporte oder generierte Dokumente für die Weitergabe verpacken.

Mehrere Dateien hinzufügen

Rufen Sie vor dem Speichern für jede Quelldatei CreateEntry auf. Da Eintragsname und Quellpfad unabhängig sind, können Sie Dateien aus verschiedenen Verzeichnissen im ZIP einheitlich anordnen.

Einen Ordner archivieren

Fügen Sie die Dateien des Quellverzeichnisses mit sicheren relativen Pfaden hinzu. Dadurch bleibt die Verzeichnisstruktur übertragbar, ohne absolute Pfade des ursprünglichen Rechners offenzulegen.

In einen Stream schreiben

Speichern Sie in einen beschreibbaren Stream, wenn Sie das ZIP über ASP.NET zurückgeben, in einen Cloudspeicher hochladen oder ohne temporäre Ausgabedatei im Arbeitsspeicher verarbeiten möchten.

So entsteht das ZIP-Archiv

  1. Installieren Sie Aspose.ZIP for .NET und binden Sie die Bibliothek ein.
  2. Erstellen Sie eine Instanz von Archive für das neue ZIP.
  3. Fügen Sie Dateien mit CreateEntry oder den Inhalt eines Verzeichnisses hinzu.
  4. Legen Sie bei Bedarf Komprimierungs- und Verschlüsselungsoptionen fest.
  5. Speichern Sie das Archiv in eine Datei oder einen beschreibbaren Stream.
  6. Geben Sie das Archiv und die von der Anwendung geöffneten Streams mit Dispose frei.

Die Archivstruktur wird beim Speichern abgeschlossen. Fügen Sie zuvor alle vorgesehenen Einträge hinzu, damit das zentrale Verzeichnis den ZIP-Inhalt korrekt beschreibt.

Dateinamen und Ordnerstruktur im Archiv festlegen

Der **Quellpfad** bestimmt, wo die Anwendung eine Datei liest. Der **Eintragsname** legt fest, unter welchem Namen und Pfad diese Datei im ZIP erscheint. Durch die Trennung können Sie Dateien umbenennen und in virtuellen Ordnern gruppieren, ohne lokale Verzeichnisnamen preiszugeben.

Verwenden Sie für verschachtelte Eintragsnamen Schrägstriche, etwa documents/2026/report.pdf. Lehnen Sie absolute Pfade, übergeordnete Pfadsegmente wie ../, leere Namen und unbeabsichtigte Duplikate ab, wenn die Namen von Benutzern oder externen Systemen stammen.

Ein ZIP mit Passwortschutz erstellen

Aspose.ZIP unterstützt das klassische ZipCrypto sowie AES mit 128-, 192- oder 256-Bit-Schlüsseln. Bevorzugen Sie AES, sofern die Software des Empfängers es unterstützt. ZipCrypto sollte nur gewählt werden, wenn die Kompatibilität mit älteren ZIP-Werkzeugen ausschlaggebend ist.

Behandeln Sie Passwörter als vertrauliche Daten: Lesen Sie sie aus einer sicheren Konfiguration, schreiben Sie sie weder in den Quellcode noch in Protokolle und übermitteln Sie sie getrennt vom Archiv. Die API bietet keine Möglichkeit, ein verlorenes Passwort wiederherzustellen.

Die passende Komprimierung wählen

Deflate ist eine bewährte Standardwahl für breit unterstützte ZIP-Archive. Je nach Daten und Empfängersoftware kommen auch BZip2, LZMA, PPMd oder der Store-Modus ohne Komprimierung infrage. Store eignet sich für bereits komprimierte Daten, wenn eine schnelle Verpackung wichtiger ist als eine geringe zusätzliche Platzersparnis.

JPEG, MP4 und viele Office-Dokumente sind bereits komprimiert und lassen sich oft kaum weiter verkleinern. Ein ZIP bleibt dennoch sinnvoll, um sie gemeinsam zu übertragen, einheitlich zu benennen, in Ordnern anzuordnen und zu schützen.

Archiv erstellen, komprimieren, entpacken oder anzeigen?

ZielPassender VorgangErgebnis
Ein neues ZIP erstellen und Dateien oder Ordner hinzufügenZIP erstellen - diese SeiteEin neues Archiv mit den ausgewählten Einträgen
Daten verkleinern oder einen anderen Archivtyp erstellenDateien mit C# komprimierenKomprimierte Daten oder ein anderes Archivformat
Dateien aus einem vorhandenen Archiv wiederherstellenArchive entpackenOriginaldateien auf dem Datenträger oder in einem Stream
Einträge prüfen, ohne sie zu entpackenArchivinhalte anzeigenEintragsnamen und verfügbare Metadaten
Den Archivschutz einrichten oder ändernArchive mit Passwort schützenEin verschlüsseltes Archiv, das das richtige Passwort erfordert

Wenn Sie eine PDF-, DOCX-, PNG- oder andere Datei zu einem ZIP hinzufügen, wird ihr internes Format nicht konvertiert. Die Originaldatei wird lediglich als Eintrag in das neue Archiv aufgenommen.

Hinweise für den Produktivbetrieb

- Geben Sie Archive und Streams zuverlässig frei, insbesondere in Diensten, die viele Pakete erstellen. - Schreiben Sie in einen Stream, wenn ein ASP.NET-Endpunkt das ZIP zurückgibt oder Sie es in einem Cloudspeicher ablegen. - Prüfen Sie bei nicht vertrauenswürdigen Anfragen Quellpfade, Eintragsnamen, Dateianzahl und gesamte Eingabegröße vor der Archivierung. - Wenn unvollständige Ausgabedateien problematisch wären, schreiben Sie zunächst an einen temporären Speicherort und ersetzen Sie die Zieldatei erst nach erfolgreichem Speichern. - Überschreiben Sie vorhandene Archive nur, wenn die Anwendung dies ausdrücklich zulässt. - Vereinheitlichen Sie Reihenfolge, Namen und Zeitstempel der Einträge, wenn Builds oder Signierprozesse reproduzierbare ZIP-Ausgaben erfordern.

Gängige Dateitypen archivieren

Wählen Sie die Anleitung für die Dateien, die Ihre Anwendung üblicherweise verpackt. Die Beispiele zeigen, wie Sie das Archiv erstellen und strukturieren; das ursprüngliche Dateiformat bleibt im ZIP unverändert.

ZIP-Dateien online erstellen

Sie benötigen ein Archiv ohne Programmierung? Nutzen Sie den kostenlosen Online-ZIP-Ersteller im Browser.

  Keine Archivierungssoftware installieren.
  Kein Code und keine API-Einrichtung nötig.
  Eine oder mehrere Dateien hochladen.
  Das fertige ZIP herunterladen.

Ressourcen zu Aspose.ZIP for .NET

Häufige Fragen

1. Wie erstelle ich eine ZIP-Datei in C#?

Erstellen Sie ein Archive, fügen Sie die Quelldatei mit CreateEntry hinzu und rufen Sie Save mit dem Ausgabepfad oder einem Stream auf. Das erste Codebeispiel auf dieser Seite zeigt den vollständigen Ablauf.

2. Kann ein Archiv mehrere Dateien enthalten?

Ja. Rufen Sie CreateEntry für jede Datei auf und speichern Sie das Archiv, nachdem alle Einträge hinzugefügt wurden.

3. Kann ich einen gesamten Ordner packen?

Ja. Fügen Sie die Dateien des Ordners mit sicheren relativen Eintragsnamen hinzu, um die gewünschte Verzeichnisstruktur im ZIP beizubehalten.

4. Kann ich in .NET ein AES-verschlüsseltes ZIP erstellen?

Ja. Wählen Sie in den Eintragseinstellungen AES-128, AES-192 oder AES-256 und beziehen Sie das Passwort aus einer sicheren Anwendungskonfiguration.

5. Müssen 7-Zip oder WinRAR installiert sein?

Nein. Aspose.ZIP erstellt das Archiv direkt in der .NET-Anwendung, ohne externe Archivierungssoftware aufzurufen.