ZipArchive.ExtractToDirectory-Methode (String, String)
Extrahiert alle Dateien im angegebenen Archiv in ein Verzeichnis im Dateisystem. Das angegebene Verzeichnis darf nicht vorhanden sind. Diese Methode erstellt alle Unterverzeichnisse und das angegebene Verzeichnis. Wenn ein Fehler beim Extrahieren gibt, bleibt das Archiv, das Archiv teilweise extrahiert. Jedem Eintrag wird so extrahiert, die die extrahierte Datei den gleichen relativen Pfad zum destinationDirectoryName verfügt, das die Eingabe das Archiv muss. Der Pfad ist zulässig, um Informationen des absoluten oder relativen Pfad angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert. Wenn eine archiviert werden Datei eine ungültige Zeitpunkt der letzten Änderung verfügt, wird das erste Datum-Zeit-darstellbare im ZIPtimestampformat (Mitternacht am 1. Januar 1980) verwendet.
Namespace: Microsoft.TeamFoundation.Server.Core
Assembly: Microsoft.TeamFoundation.Server.Core (in Microsoft.TeamFoundation.Server.Core.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
Der Pfad zum Archiv im Dateisystem, das extrahiert werden soll.
- destinationDirectoryName
Typ: System.String
Der Pfad zum Verzeichnis im Dateisystem.Das angegebene Verzeichnis darf nicht vorhanden sind, das Verzeichnis, in der sie enthalten ist, muss vorhanden sein.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentException | oder destinationDirectoryName ist eine Zeichenfolge der Länge 0 sourceArchive, enthält nur Leerzeichen, oder enthält mindestens ungültigen Zeichen, wie durch InvalidPathChars definiert. |
| ArgumentNullException | sourceArchive oder destinationDirectoryName ist ungültig. |
| PathTooLongException | sourceArchive oder destinationDirectoryName gibt einem Pfad, Dateinamen an, oder beide überschreiten die systemdefinierte maximale Länge. Beispielsweise müssen Pfade auf Windows-Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen aufweisen. |
| DirectoryNotFoundException | Der Pfad, der von sourceArchive oder destinationDirectoryName angegeben wird, ist ungültig, (beispielsweise, ist er auf einem nicht zugeordneten Laufwerk). |
| IOException | Das Verzeichnis, das durch destinationDirectoryName angegeben ist bereits vorhanden ist. - oder ein E/A-Fehler ist aufgetreten. - oder ein Name des Archiveintrags ist der Länge 0, der Pfad enthält nur Leerzeichen, oder enthält mindestens ungültigen Zeichen, wie durch InvalidPathChars definiert. - oder das Extrahieren eines Archiveintrags würde ein Dateiziel ergeben, das außerhalb des Zielverzeichnisses ist, (beispielsweise aufgrund der Accessoren des übergeordneten Verzeichnisses). - oder ein Archiveintrag besitzt den Namen, den ein bereits extrahierter Eintrag aus der gleichen Datei. |
| UnauthorizedAccessException | Der Aufrufer verfügt nicht über die erforderliche Berechtigung. |
| NotSupportedException | sourceArchive oder destinationDirectoryName hat ein ungültiges Format. |
| FileNotFoundException | sourceArchive wurde nicht gefunden. |
| InvalidDataException | Das Archiv angegeben durch sourceArchive: Nicht als gültiges ZipArchive - oder ein Archiveintrag wurde nicht gefunden oder ist beschädigt. - oder ein Archiveintrag ist mit einer Komprimierungsmethode komprimiert wurde, die nicht unterstützt wird. |
.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.