ZipArchive.ExtractToDirectory-Methode (String, String)
Extrahiert alle Dateien in das angegebene 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 Archiv hat. Der Pfad dürfen relative oder absolute Pfadinformationen angegeben werden. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert. 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 Shared Sub ExtractToDirectory ( _
sourceArchiveFileName As String, _
destinationDirectoryName As String _
)
public static void ExtractToDirectory(
string sourceArchiveFileName,
string destinationDirectoryName
)
Parameter
- sourceArchiveFileName
Typ: System.String
- destinationDirectoryName
Typ: System.String
Der Pfad des Verzeichnisses im Dateisystem.Das angegebene Verzeichnis darf nicht vorhanden sein, aber das Verzeichnis, dem darin enthaltene muss vorhanden sein.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentException | SourceArchive oder 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 | SourceArchive oder DestinationDirectoryName ist null. |
| PathTooLongException | SourceArchive oder DestinationDirectoryName gibt einen Pfad, Dateiname oder beide vom System definierte maximale Länge überschreiten. Beispielsweise müssen Pfade auf Windows-Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen haben. |
| DirectoryNotFoundException | Durch SourceArchive oder DestinationDirectoryName angegebene Pfad ist ungültig; zum Beispiel, wenn es auf einem nicht zugeordneten Laufwerk. |
| IOException | Bereits durch DestinationDirectoryName angegebene Verzeichnis vorhanden ist; e/a-Fehler oder einen Archiv-Eintrag Name hat die Länge 0 (null), enthält nur Leerraum oder enthält ein oder mehrere ungültige Zeichen durch InvalidPathChars definiert; oder einen Eintrag Archiv extrahieren würde Ihnen ein Ziel, das außerhalb des Zielverzeichnisses (z. B. wegen einer übergeordneten Verzeichnis Accessoren); 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 | SourceArchive oder DestinationDirectoryName ist ein ungültiges Format. |
| FileNotFoundException | SourceArchive wurde nicht gefunden. |
| InvalidDataException | Das Archiv von SourceArchive angegeben ist keine gültige ZipArchive 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
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.