ZipFile.CreateFromDirectory Methode

Definition

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.ZipFile.dll

Erstellt ein ZIP-Archiv, das die Dateien und Verzeichnisse im angegebenen Verzeichnis enthält.

Überlädt

CreateFromDirectory(String, Stream)	Erstellt ein ZIP-Archiv im angegebenen Stream, das die Dateien und Verzeichnisse aus dem angegebenen Verzeichnis enthält.
CreateFromDirectory(String, String)	Erstellt ein ZIP-Archiv, das die Dateien und Verzeichnisse im angegebenen Verzeichnis enthält.
CreateFromDirectory(String, Stream, CompressionLevel, Boolean)	Erstellt ein ZIP-Archiv im angegebenen Stream, das die Dateien und Verzeichnisse aus dem angegebenen Verzeichnis enthält, die angegebene Komprimierungsebene verwendet und optional das Basisverzeichnis einschließt.
CreateFromDirectory(String, String, CompressionLevel, Boolean)	Erstellt ein ZIP-Archiv, das die Dateien und Verzeichnisse im angegebenen Verzeichnis enthält, verwendet die angegebene Komprimierungsebene und optional das Basisverzeichnis.
CreateFromDirectory(String, Stream, CompressionLevel, Boolean, Encoding)	Erstellt ein ZIP-Archiv im angegebenen Stream, das die Dateien und Verzeichnisse aus dem angegebenen Verzeichnis enthält, verwendet die angegebene Komprimierungsebene und Zeichencodierung für Eintragsnamen und schließt optional das Basisverzeichnis ein.
CreateFromDirectory(String, String, CompressionLevel, Boolean, Encoding)	Erstellt ein ZIP-Archiv, das die Dateien und Verzeichnisse im angegebenen Verzeichnis enthält, die angegebene Komprimierungsebene und der angegebenen Zeichencodierung für Eintragsnamen verwendet und optional das Basisverzeichnis mit einbezieht.

CreateFromDirectory(String, Stream)

Quelle:

ZipFile.Create.cs

Erstellt ein ZIP-Archiv im angegebenen Stream, das die Dateien und Verzeichnisse aus dem angegebenen Verzeichnis enthält.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::IO::Stream ^ destination);

public static void CreateFromDirectory (string sourceDirectoryName, System.IO.Stream destination);

static member CreateFromDirectory : string * System.IO.Stream -> unit

Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destination As Stream)

Parameter

sourceDirectoryName

String

Der Pfad zum Verzeichnis, das archiviert werden soll, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.

destination

Stream

Der Stream, in dem das ZIP-Archiv gespeichert werden soll.

Ausnahmen

ArgumentException

sourceDirectoryName ist gleich Empty, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen.

- oder -

Das destination Schreiben wird vom Stream nicht unterstützt.

ArgumentNullException

sourceDirectoryName oder destination ist null.

PathTooLongException

Im sourceDirectoryName angegebenen Pfad überschreiten der Dateiname oder beide die systemdefinierte maximale Länge.

DirectoryNotFoundException

sourceDirectoryName ist ungültig oder nicht vorhanden (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).

IOException

Eine Datei im angegebenen Verzeichnis konnte nicht geöffnet werden.

- oder -

Beim Öffnen einer zu archivierenden Datei ist ein E/A-Fehler aufgetreten.

NotSupportedException

sourceDirectoryName enthält ein ungültiges Format.

Hinweise

Die Verzeichnisstruktur aus dem Dateisystem wird im Archiv beibehalten. Wenn das Verzeichnis leer ist, wird ein leeres Archiv erstellt. Diese Methodenüberladung enthält nicht das Basisverzeichnis im Archiv und ermöglicht es Ihnen nicht, eine Komprimierungsebene anzugeben. Wenn Sie das Basisverzeichnis einschließen oder eine Komprimierungsebene angeben möchten, rufen Sie die CreateFromDirectory(String, Stream, CompressionLevel, Boolean) Methodenüberladung auf. Wenn eine Datei im Verzeichnis dem Archiv nicht hinzugefügt werden kann, bleibt das Archiv unvollständig und ungültig, und die Methode löst eine Ausnahme aus IOException .

CreateFromDirectory(String, String)

Quelle:

ZipFile.Create.cs

Erstellt ein ZIP-Archiv, das die Dateien und Verzeichnisse im angegebenen Verzeichnis enthält.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationArchiveFileName);

public static void CreateFromDirectory (string sourceDirectoryName, string destinationArchiveFileName);

static member CreateFromDirectory : string * string -> unit

Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destinationArchiveFileName As String)

Parameter

sourceDirectoryName

String

Der Pfad zum Verzeichnis, das archiviert werden soll, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.

destinationArchiveFileName

String

Der Pfad des zu erstellenden Archivs, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.

Ausnahmen

ArgumentException

sourceDirectoryName oder destinationArchiveFileName ist Empty, enthält nur Leerraum oder mindestens ein ungültiges Zeichen.

ArgumentNullException

sourceDirectoryName oder destinationArchiveFileName ist null.

PathTooLongException

Im sourceDirectoryName oder destinationArchiveFileName überschreiten der angegebene Pfad und/oder der Dateiname die vom System vorgegebene Höchstlänge.

DirectoryNotFoundException

sourceDirectoryName ist ungültig oder nicht vorhanden (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).

IOException

destinationArchiveFileName ist bereits vorhanden.

- oder -

Eine Datei im angegebenen Verzeichnis konnte nicht geöffnet werden.

- oder -

Beim Öffnen einer zu archivierenden Datei ist ein E/A-Fehler aufgetreten.

UnauthorizedAccessException

destinationArchiveFileName gibt ein Verzeichnis an.

- oder -

Der Aufrufer verfügt nicht über die erforderliche Berechtigung für den Zugriff auf das in sourceDirectoryName angegebene Verzeichnis oder die in destinationArchiveFileName angegebene Datei.

NotSupportedException

sourceDirectoryName oder destinationArchiveFileName enthält ein ungültiges Format.

- oder -

Das ZIP-Archiv unterstützt keine Schreibvorgänge.

Beispiele

In diesem Beispiel wird gezeigt, wie Sie mithilfe der ZipFile -Klasse ein ZIP-Archiv erstellen und extrahieren. Der Inhalt eines Ordners wird in ein ZIP-Archiv komprimiert und dann in einen neuen Ordner extrahiert. Um die ZipFile-Klasse zu verwenden, müssen Sie auf die System.IO.Compression.FileSystem-Assembly in Ihrem Projekt verweisen.

using System;
using System.IO.Compression;

class Program
{
    static void Main(string[] args)
    {
        string startPath = @".\start";
        string zipPath = @".\result.zip";
        string extractPath = @".\extract";

        ZipFile.CreateFromDirectory(startPath, zipPath);

        ZipFile.ExtractToDirectory(zipPath, extractPath);
    }
}

open System.IO.Compression

let startPath = @".\start"
let zipPath = @".\result.zip"
let extractPath = @".\extract"

ZipFile.CreateFromDirectory(startPath, zipPath)

ZipFile.ExtractToDirectory(zipPath, extractPath)

Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim startPath As String = ".\start"
        Dim zipPath As String = ".\result.zip"
        Dim extractPath As String = ".\extract"

        ZipFile.CreateFromDirectory(startPath, zipPath)

        ZipFile.ExtractToDirectory(zipPath, extractPath)
    End Sub

End Module

Hinweise

Die Verzeichnisstruktur aus dem Dateisystem wird im Archiv beibehalten. Wenn das Verzeichnis leer ist, wird ein leeres Archiv erstellt. Diese Methodenüberladung enthält nicht das Basisverzeichnis im Archiv und ermöglicht es Ihnen nicht, eine Komprimierungsebene anzugeben. Wenn Sie das Basisverzeichnis einschließen oder eine Komprimierungsebene angeben möchten, rufen Sie die CreateFromDirectory(String, String, CompressionLevel, Boolean) Methodenüberladung auf.

Wenn das Archiv bereits vorhanden ist, wird eine IOException Ausnahme ausgelöst. Wenn bereits ein Eintrag mit dem angegebenen Namen im Archiv vorhanden ist, wird ein zweiter Eintrag mit einem identischen Namen erstellt.

Wenn eine Datei im Verzeichnis dem Archiv nicht hinzugefügt werden kann, bleibt das Archiv unvollständig und ungültig, und die Methode löst eine Ausnahme aus IOException .

CreateFromDirectory(String, Stream, CompressionLevel, Boolean)

Quelle:

ZipFile.Create.cs

Erstellt ein ZIP-Archiv im angegebenen Stream, das die Dateien und Verzeichnisse aus dem angegebenen Verzeichnis enthält, die angegebene Komprimierungsebene verwendet und optional das Basisverzeichnis einschließt.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::IO::Stream ^ destination, System::IO::Compression::CompressionLevel compressionLevel, bool includeBaseDirectory);

public static void CreateFromDirectory (string sourceDirectoryName, System.IO.Stream destination, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory);

static member CreateFromDirectory : string * System.IO.Stream * System.IO.Compression.CompressionLevel * bool -> unit

Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destination As Stream, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean)

Parameter

sourceDirectoryName

String

Der Pfad zum Verzeichnis, das archiviert werden soll, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.

destination

Stream

Der Stream, in dem das ZIP-Archiv gespeichert werden soll.

compressionLevel

CompressionLevel

Einer der Enumerationswerte, der angibt, ob Geschwindigkeit oder Komprimierungseffektivität priorisiert wird, wenn der Eintrag erstellt.

includeBaseDirectory

Boolean

true, um den Verzeichnisnamens von sourceDirectoryName am Stamm des Archivs einzuschließen; false, um nur der Inhalt des Verzeichnisses einzuschließen.

Ausnahmen

ArgumentException

sourceDirectoryName ist gleich Empty, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen.

- oder -

Das destination Schreiben wird vom Stream nicht unterstützt.

ArgumentNullException

sourceDirectoryName oder destination ist null.

PathTooLongException

Im sourceDirectoryName angegebenen Pfad überschreiten der Dateiname oder beide die systemdefinierte maximale Länge.

DirectoryNotFoundException

sourceDirectoryName ist ungültig oder nicht vorhanden (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).

IOException

Eine Datei im angegebenen Verzeichnis konnte nicht geöffnet werden.

- oder -

Beim Öffnen einer zu archivierenden Datei ist ein E/A-Fehler aufgetreten.

NotSupportedException

sourceDirectoryName enthält ein ungültiges Format.

ArgumentOutOfRangeException

compressionLevel ist kein gültiger CompressionLevel-Wert.

Hinweise

Die Verzeichnisstruktur aus dem Dateisystem wird im Archiv beibehalten. Wenn das Verzeichnis leer ist, wird ein leeres Archiv erstellt. Verwenden Sie diese Methodenüberladung, um die Komprimierungsebene anzugeben und anzugeben, ob das Basisverzeichnis in das Archiv eingeschlossen werden soll. Wenn eine Datei im Verzeichnis dem Archiv nicht hinzugefügt werden kann, bleibt das Archiv unvollständig und ungültig, und die Methode löst eine Ausnahme aus IOException .

CreateFromDirectory(String, String, CompressionLevel, Boolean)

Quelle:

ZipFile.Create.cs

Erstellt ein ZIP-Archiv, das die Dateien und Verzeichnisse im angegebenen Verzeichnis enthält, verwendet die angegebene Komprimierungsebene und optional das Basisverzeichnis.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationArchiveFileName, System::IO::Compression::CompressionLevel compressionLevel, bool includeBaseDirectory);

public static void CreateFromDirectory (string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory);

static member CreateFromDirectory : string * string * System.IO.Compression.CompressionLevel * bool -> unit

Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destinationArchiveFileName As String, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean)

Parameter

sourceDirectoryName

String

Der Pfad zum Verzeichnis, das archiviert werden soll, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.

destinationArchiveFileName

String

Der Pfad des zu erstellenden Archivs, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.

compressionLevel

CompressionLevel

Einer der Enumerationswerte, der angibt, ob Geschwindigkeit oder Komprimierungseffektivität priorisiert wird, wenn der Eintrag erstellt.

includeBaseDirectory

Boolean

true, um den Verzeichnisnamens von sourceDirectoryName am Stamm des Archivs einzuschließen; false, um nur der Inhalt des Verzeichnisses einzuschließen.

Ausnahmen

ArgumentException

sourceDirectoryName oder destinationArchiveFileName ist Empty, enthält nur Leerraum oder mindestens ein ungültiges Zeichen.

ArgumentNullException

sourceDirectoryName oder destinationArchiveFileName ist null.

PathTooLongException

Im sourceDirectoryName oder destinationArchiveFileName überschreiten der angegebene Pfad und/oder der Dateiname die vom System vorgegebene Höchstlänge.

DirectoryNotFoundException

sourceDirectoryName ist ungültig oder nicht vorhanden (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).

IOException

destinationArchiveFileName ist bereits vorhanden.

- oder -

Eine Datei im angegebenen Verzeichnis konnte nicht geöffnet werden.

- oder -

Beim Öffnen einer zu archivierenden Datei ist ein E/A-Fehler aufgetreten.

UnauthorizedAccessException

destinationArchiveFileName gibt ein Verzeichnis an.

- oder -

Der Aufrufer verfügt nicht über die erforderliche Berechtigung für den Zugriff auf das in sourceDirectoryName angegebene Verzeichnis oder die in destinationArchiveFileName angegebene Datei.

NotSupportedException

sourceDirectoryName oder destinationArchiveFileName enthält ein ungültiges Format.

- oder -

Das ZIP-Archiv unterstützt keine Schreibvorgänge.

Beispiele

In diesem Beispiel wird gezeigt, wie Sie mithilfe der ZipFile -Klasse ein ZIP-Archiv erstellen und extrahieren. Der Inhalt eines Ordners wird in ein ZIP-Archiv komprimiert und dann in einen neuen Ordner extrahiert. Beim Komprimieren des Archivs ist das Basisverzeichnis enthalten, und die Komprimierungsebene wird festgelegt, um die Geschwindigkeit des Vorgangs gegenüber der Effizienz hervorzuheben. Um die ZipFile-Klasse zu verwenden, müssen Sie auf die System.IO.Compression.FileSystem-Assembly in Ihrem Projekt verweisen.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string startPath = @"c:\example\start";
            string zipPath = @"c:\example\result.zip";
            string extractPath = @"c:\example\extract";

            ZipFile.CreateFromDirectory(startPath, zipPath, CompressionLevel.Fastest, true);

            ZipFile.ExtractToDirectory(zipPath, extractPath);
        }
    }
}

open System.IO.Compression

let startPath = @"c:\example\start"
let zipPath = @"c:\example\result.zip"
let extractPath = @"c:\example\extract"

ZipFile.CreateFromDirectory(startPath, zipPath, CompressionLevel.Fastest, true)

ZipFile.ExtractToDirectory(zipPath, extractPath)

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim startPath As String = "c:\example\start"
        Dim zipPath As String = "c:\example\result.zip"
        Dim extractPath As String = "c:\example\extract"

        ZipFile.CreateFromDirectory(startPath, zipPath, CompressionLevel.Fastest, True)

        ZipFile.ExtractToDirectory(zipPath, extractPath)
    End Sub

End Module

Hinweise

Die Verzeichnisstruktur aus dem Dateisystem wird im Archiv beibehalten. Wenn das Verzeichnis leer ist, wird ein leeres Archiv erstellt. Verwenden Sie diese Methodenüberladung, um die Komprimierungsebene anzugeben und anzugeben, ob das Basisverzeichnis in das Archiv eingeschlossen werden soll.

Wenn das Archiv bereits vorhanden ist, wird eine IOException Ausnahme ausgelöst. Wenn bereits ein Eintrag mit dem angegebenen Namen im Archiv vorhanden ist, wird ein zweiter Eintrag mit einem identischen Namen erstellt.

Wenn eine Datei im Verzeichnis dem Archiv nicht hinzugefügt werden kann, bleibt das Archiv unvollständig und ungültig, und die Methode löst eine Ausnahme aus IOException .

CreateFromDirectory(String, Stream, CompressionLevel, Boolean, Encoding)

Quelle:

ZipFile.Create.cs

Erstellt ein ZIP-Archiv im angegebenen Stream, das die Dateien und Verzeichnisse aus dem angegebenen Verzeichnis enthält, verwendet die angegebene Komprimierungsebene und Zeichencodierung für Eintragsnamen und schließt optional das Basisverzeichnis ein.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::IO::Stream ^ destination, System::IO::Compression::CompressionLevel compressionLevel, bool includeBaseDirectory, System::Text::Encoding ^ entryNameEncoding);

public static void CreateFromDirectory (string sourceDirectoryName, System.IO.Stream destination, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding? entryNameEncoding);

static member CreateFromDirectory : string * System.IO.Stream * System.IO.Compression.CompressionLevel * bool * System.Text.Encoding -> unit

Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destination As Stream, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, entryNameEncoding As Encoding)

Parameter

sourceDirectoryName

String

Der Pfad zum Verzeichnis, das archiviert werden soll, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.

destination

Stream

Der Stream, in dem das ZIP-Archiv gespeichert werden soll.

compressionLevel

CompressionLevel

Einer der Enumerationswerte, der angibt, ob Geschwindigkeit oder Komprimierungseffektivität priorisiert wird, wenn der Eintrag erstellt.

includeBaseDirectory

Boolean

true, um den Verzeichnisnamens von sourceDirectoryName am Stamm des Archivs einzuschließen; false, um nur der Inhalt des Verzeichnisses einzuschließen.

entryNameEncoding

Encoding

Die Codierung, die beim Lesen oder Schreiben von Eintragsnamen in diesem Archiv verwendet werden soll. Geben Sie einen Wert für diesen Parameter nur an, wenn eine Codierung für die Interoperabilität mit ZIP-Archiv-Tools und -Bibliotheken erforderlich ist, die die UTF-8-Codierung für Eintragsnamen nicht unterstützen.

Ausnahmen

ArgumentException

sourceDirectoryName ist gleich Empty, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen.

- oder -

Das destination Schreiben wird vom Stream nicht unterstützt.

ArgumentNullException

sourceDirectoryName oder destination ist null.

PathTooLongException

Im sourceDirectoryName angegebenen Pfad überschreiten der Dateiname oder beide die systemdefinierte maximale Länge.

DirectoryNotFoundException

sourceDirectoryName ist ungültig oder nicht vorhanden (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).

IOException

Eine Datei im angegebenen Verzeichnis konnte nicht geöffnet werden.

- oder -

Beim Öffnen einer zu archivierenden Datei ist ein E/A-Fehler aufgetreten.

NotSupportedException

sourceDirectoryName enthält ein ungültiges Format.

ArgumentOutOfRangeException

compressionLevel ist kein gültiger CompressionLevel-Wert.

Hinweise

Die Verzeichnisstruktur aus dem Dateisystem wird im Archiv beibehalten. Wenn das Verzeichnis leer ist, wird ein leeres Archiv erstellt. Verwenden Sie diese Methodenüberladung, um die Komprimierungsebene und zeichencodierung anzugeben und anzugeben, ob das Basisverzeichnis in das Archiv eingeschlossen werden soll. Wenn eine Datei im Verzeichnis dem Archiv nicht hinzugefügt werden kann, bleibt das Archiv unvollständig und ungültig, und die Methode löst eine Ausnahme aus IOException .

CreateFromDirectory(String, String, CompressionLevel, Boolean, Encoding)

Quelle:

ZipFile.Create.cs

Erstellt ein ZIP-Archiv, das die Dateien und Verzeichnisse im angegebenen Verzeichnis enthält, die angegebene Komprimierungsebene und der angegebenen Zeichencodierung für Eintragsnamen verwendet und optional das Basisverzeichnis mit einbezieht.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationArchiveFileName, System::IO::Compression::CompressionLevel compressionLevel, bool includeBaseDirectory, System::Text::Encoding ^ entryNameEncoding);

public static void CreateFromDirectory (string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding? entryNameEncoding);

static member CreateFromDirectory : string * string * System.IO.Compression.CompressionLevel * bool * System.Text.Encoding -> unit

Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destinationArchiveFileName As String, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, entryNameEncoding As Encoding)

Parameter

sourceDirectoryName

String

Der Pfad zum Verzeichnis, das archiviert werden soll, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.

destinationArchiveFileName

String

Der Pfad des zu erstellenden Archivs, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.

compressionLevel

CompressionLevel

Einer der Enumerationswerte, der angibt, ob Geschwindigkeit oder Komprimierungseffektivität priorisiert wird, wenn der Eintrag erstellt.

includeBaseDirectory

Boolean

true, um den Verzeichnisnamens von sourceDirectoryName am Stamm des Archivs einzuschließen; false, um nur der Inhalt des Verzeichnisses einzuschließen.

entryNameEncoding

Encoding

Die Codierung, die beim Lesen oder Schreiben von Eintragsnamen in diesem Archiv verwendet werden soll. Geben Sie einen Wert für diesen Parameter nur an, wenn eine Codierung für die Interoperabilität mit ZIP-Archiv-Tools und -Bibliotheken erforderlich ist, die die UTF-8-Codierung für Eintragsnamen nicht unterstützen.

Ausnahmen

ArgumentException

sourceDirectoryName oder destinationArchiveFileName ist Empty, enthält nur Leerraum oder mindestens ein ungültiges Zeichen.

- oder -

entryNameEncoding wird auf eine andere Unicode-Codierung als UTF-8 festgelegt.

ArgumentNullException

sourceDirectoryName oder destinationArchiveFileName ist null.

PathTooLongException

Im sourceDirectoryName oder destinationArchiveFileName überschreiten der angegebene Pfad und/oder der Dateiname die vom System vorgegebene Höchstlänge.

DirectoryNotFoundException

sourceDirectoryName ist ungültig oder nicht vorhanden (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).

IOException

destinationArchiveFileName ist bereits vorhanden.

- oder -

Eine Datei im angegebenen Verzeichnis konnte nicht geöffnet werden.

- oder -

Beim Öffnen einer zu archivierenden Datei ist ein E/A-Fehler aufgetreten.

UnauthorizedAccessException

destinationArchiveFileName gibt ein Verzeichnis an.

- oder -

Der Aufrufer verfügt nicht über die erforderliche Berechtigung für den Zugriff auf das in sourceDirectoryName angegebene Verzeichnis oder die in destinationArchiveFileName angegebene Datei.

NotSupportedException

sourceDirectoryName oder destinationArchiveFileName enthält ein ungültiges Format.

- oder -

Das ZIP-Archiv unterstützt keine Schreibvorgänge.

Hinweise

Die Verzeichnisstruktur aus dem Dateisystem wird im Archiv beibehalten. Wenn das Verzeichnis leer ist, wird ein leeres Archiv erstellt. Verwenden Sie diese Methodenüberladung, um die Komprimierungsebene und zeichencodierung anzugeben und anzugeben, ob das Basisverzeichnis in das Archiv eingeschlossen werden soll.

Wenn das Archiv bereits vorhanden ist, wird eine IOException Ausnahme ausgelöst. Wenn bereits ein Eintrag mit dem angegebenen Namen im Archiv vorhanden ist, wird ein zweiter Eintrag mit einem identischen Namen erstellt.

Wenn eine Datei im Verzeichnis dem Archiv nicht hinzugefügt werden kann, bleibt das Archiv unvollständig und ungültig, und die Methode löst eine Ausnahme aus IOException .

Wenn entryNameEncoding auf einen anderen Wert als nullfestgelegt ist, werden die Eintragsnamen mithilfe der angegebenen Codierung codiert. Wenn die angegebene Codierung utf-8 ist, wird das Sprachcodierungsflag (im universellen Bitflag des lokalen Dateiheaders) für jeden Eintrag festgelegt.

Wenn entryNameEncoding auf nullfestgelegt ist, werden die Eintragsnamen gemäß den folgenden Regeln codiert:

• Für Eintragsnamen, die Zeichen außerhalb des ASCII-Bereichs enthalten, wird das Sprachcodierungsflag festgelegt, und UTF-8 wird zum Codieren des Eintragsnamens verwendet.

• Für Eintragsnamen, die nur ASCII-Zeichen enthalten, wird das Sprachcodierungsflag festgelegt, und die aktuelle Standardcodepage des Systems wird zum Codieren der Eintragsnamen verwendet.