Freigeben über


ZipArchive-Konstruktor (String, ZipArchiveMode)

Öffnet ein ZipArchive im angegebenen Pfad im angegebenen ZipArchiveMode-Modus.

Namespace:  Microsoft.TeamFoundation.Server.Core
Assembly:  Microsoft.TeamFoundation.Server.Core (in Microsoft.TeamFoundation.Server.Core.dll)

Syntax

'Declaration
Public Sub New ( _
    archiveFileName As String, _
    mode As ZipArchiveMode _
)
public ZipArchive(
    string archiveFileName,
    ZipArchiveMode mode
)

Parameter

  • archiveFileName
    Typ: System.String
    Eine Zeichenfolge, die den Pfad auf dem Dateisystem angibt, um das Archiv an zu öffnen.Der Pfad ist zulässig, um Informationen des absoluten oder relativen Pfad angeben.Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
  • mode
    Typ: Microsoft.TeamFoundation.Server.Core.ZipArchiveMode
    Siehe dazu die Beschreibung der ZipArchiveMode-Enumeration.Wenn Lesen angegeben ist, wird die Datei mit System.IO.FileMode.Open geöffnet und ist ein FileNotFoundException auslösen, wenn die Datei nicht vorhanden ist.Wenn Sie angegeben ist, wird die Datei mit System.IO.FileMode.CreateNew geöffnet und ist ein System.IO.IOException auslösen, wenn die Datei bereits vorhanden ist.Wenn Update angegeben ist, wird die Datei mit System.IO.FileMode.OpenOrCreate geöffnet.Wenn die Datei vorhanden und ZIP-Datei ist, werden dessen Einträge werden zugänglich und möglicherweise geändert, und neue Einträge können erstellt werden.Wenn die Datei keine ZIP-Dateien vorhanden und ist, wird ein ZipArchiveException ausgelöst.Wenn die Datei nicht vorhanden und ist leer oder ist, wird eine neue ZIP-Datei erstellt.Beachten Sie, dass eine ZIP-Datei mit dem ZipArchiveMode.Create-Modus erstellt, ist effizienter, wenn Sie eine neue ZIP-Datei erstellen.

Ausnahmen

Ausnahme Bedingung
ArgumentException

Pfad ist eine Zeichenfolge der Länge 0, der Pfad enthält nur Leerzeichen, oder enthält mindestens ungültigen Zeichen, wie durch InvalidPathChars definiert.

ArgumentNullException

path ist NULL.

PathTooLongException

Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise müssen Pfade auf Windows-Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen aufweisen.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).

IOException

E/A-Fehler beim Öffnen der Datei.

UnauthorizedAccessException

Pfad ist ein Verzeichnis an. - oder der Aufrufer verfügt nicht über die erforderliche Berechtigung.

ArgumentOutOfRangeException

Modus hat einen ungültigen Wert an.

FileNotFoundException

Die Datei, die im Pfad angegeben wurde, wurde nicht gefunden.

NotSupportedException

Pfad ist in ein ungültiges Format.

InvalidDataException

Die angegebene Datei kann nicht als ZIP-Datei interpretiert werden. - oder - Modus ist Update und einem Eintrag fehlt im Archiv oder ist beschädigt und kann nicht gelesen werden. - oder - Modus ist Update und einem Eintrag ist zu groß, in den Arbeitsspeicher zu passen.

.NET Framework-Sicherheit

Siehe auch

Referenz

ZipArchive Klasse

ZipArchive-Überladung

Microsoft.TeamFoundation.Server.Core-Namespace