ZipArchive.ExtractToDirectory-Methode (String)

Extrahiert alle Dateien in das Archiv in ein Verzeichnis im Dateisystem. Das angegebene Verzeichnis muss nicht vorhanden sein. Diese Methode erstellt alle Unterverzeichnisse und das angegebene Verzeichnis. Liegt ein Fehler beim Extrahieren des Archivs, bleibt teilweise extrahierten das Archiv. Jeder Eintrag wird extrahiert werden, so dass die extrahierte Datei den gleichen relativen Pfad der DestinationDirectoryName hat wie der Eintrag in das Stammverzeichnis des Archivs. Wenn eine Datei archiviert werden eine ungültige Zeit der letzten Änderung, die erste Datetime darstellbar in der Zip-Timestamp-Format (Mitternacht am 1. Januar 1980) verwendet werden.

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

Syntax

'Declaration
Public Sub ExtractToDirectory ( _
    destinationDirectoryName As String _
)
public void ExtractToDirectory(
    string destinationDirectoryName
)

Parameter

  • destinationDirectoryName
    Typ: System.String
    Der Pfad des Verzeichnisses im Dateisystem.Das angegebene Verzeichnis muss nicht vorhanden sein.Der Pfad dürfen relative oder absolute Pfadinformationen angegeben werden.Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.

Ausnahmen

Ausnahme Bedingung
ArgumentException

DestinationDirectoryName ist eine Zeichenfolge der Länge 0 (null), oder enthält nur Leerzeichen, er enthält ein oder mehrere ungültige Zeichen durch InvalidPathChars definiert.

ArgumentNullException

DestinationDirectoryName 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 haben.

DirectoryNotFoundException

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

IOException

Bereits durch DestinationDirectoryName angegebene Verzeichnis vorhanden ist; ein Archiv-Eintrag Name ist Null-Länge oder enthält nur Leerzeichen oder es enthält ein oder mehrere ungültige Zeichen durch InvalidPathChars definiert; oder einen Eintrag Archiv extrahieren würde haben eine Zieldatei, die sich außerhalb der DestinationDirectoryName (z. B. das übergeordnete Verzeichnis Accessoren enthält); oder ein Archiv-Eintrag hat denselben Namen wie ein bereits extrahierten Eintrag aus dem gleichen Archiv.

UnauthorizedAccessException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

NotSupportedException

DestinationDirectoryName ist ein ungültiges Format.

InvalidDataException

Ein Archiv-Eintrag wurde nicht gefunden oder war beschädigt, oder ein Archiv-Eintrag ist mit eine Komprimierungsmethode, die nicht unterstützt wird komprimiert.

.NET Framework-Sicherheit

Siehe auch

Referenz

ZipArchive Klasse

ExtractToDirectory-Überladung

Microsoft.TeamFoundation.Framework.Server-Namespace