ZipFileExtensions.ExtractToDirectoryAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
Extrahiert asynchron alle Dateien im Archiv in ein Verzeichnis im Dateisystem. Das angegebene Verzeichnis kann bereits vorhanden sein. |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
Extrahiert alle Dateien im Archiv in ein Verzeichnis im Dateisystem. Das angegebene Verzeichnis ist möglicherweise bereits vorhanden. |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
Extrahiert asynchron alle Dateien im Archiv in ein Verzeichnis im Dateisystem. Das angegebene Verzeichnis kann bereits vorhanden sein.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- source
- ZipArchive
Das ZIP-Archiv zum Extrahieren von Dateien aus.
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis im Dateisystem.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
destinationDirectoryName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
destinationDirectoryName ist null.
Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge. Auf Windows-basierten Plattformen müssen Pfade beispielsweise kleiner als 248 Zeichen sein, und Dateinamen müssen kleiner als 260 Zeichen sein.
Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Der Name eines Archiveintrags ist null lang, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
-oder-
Das Extrahieren eines Archiveintrags hätte zu einer Zieldatei geführt, die sich außerhalb destinationDirectoryName befindet (z. B. wenn der Eintragsname übergeordnete Verzeichnisaccessoren enthält).
-oder-
Ein Archiveintrag hat denselben Namen wie ein bereits extrahierter Eintrag aus demselben Archiv.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
destinationDirectoryName ist in einem ungültigen Format vorhanden.
Ein Archiveintrag wurde nicht gefunden oder ist beschädigt.
-oder-
Ein Archiveintrag wurde mithilfe einer nicht unterstützten Komprimierungsmethode komprimiert.
Ein asynchroner Vorgang wird abgebrochen.
Hinweise
Das angegebene Verzeichnis darf nicht vorhanden sein. Der Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
Diese Methode erstellt bei Bedarf alle Unterverzeichnisse und das angegebene Verzeichnis.
Wenn beim Extrahieren des Archivs ein Fehler auftritt, bleibt das Archiv teilweise extrahiert.
Jeder Eintrag wird extrahiert, sodass die extrahierte Datei denselben relativen Pfad destinationDirectoryName wie der Eintrag zum Stammverzeichnis des Archivs hat. Wenn eine zu archivierende Datei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste datumstime im Zip-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet.
Gilt für:
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
Extrahiert alle Dateien im Archiv in ein Verzeichnis im Dateisystem. Das angegebene Verzeichnis ist möglicherweise bereits vorhanden.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- source
- ZipArchive
Das ZIP-Archiv zum Extrahieren von Dateien aus.
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis im Dateisystem.
- overwriteFiles
- Boolean
true um Dateien zu überschreiben; false Andernfalls.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
destinationDirectoryName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
Diese Methode erstellt bei Bedarf alle Unterverzeichnisse und das angegebene Verzeichnis.
Wenn beim Extrahieren des Archivs ein Fehler auftritt, bleibt das Archiv teilweise extrahiert.
Jeder Eintrag wird extrahiert, sodass die extrahierte Datei denselben relativen Pfad destinationDirectoryName wie der Eintrag zum Stammverzeichnis des Archivs hat. Wenn eine zu archivierende Datei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste datumstime im Zip-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet.
destinationDirectoryName ist null.
Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.
Auf Windows-basierten Plattformen müssen Pfade beispielsweise kleiner als 248 Zeichen sein, und Dateinamen müssen kleiner als 260 Zeichen sein.
Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Der Name eines Archiveintrags ist null lang, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
-oder-
Das Extrahieren eines Archiveintrags hätte zu einer Zieldatei geführt, die sich außerhalb destinationDirectoryName befindet (z. B. wenn der Eintragsname übergeordnete Verzeichnisaccessoren enthält).
-oder-
Ein Archiveintrag hat denselben Namen wie ein bereits extrahierter Eintrag aus demselben Archiv.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
destinationDirectoryName ist in einem ungültigen Format vorhanden.
Ein Archiveintrag wurde nicht gefunden oder beschädigt.
-oder-
Ein Archiveintrag wurde mithilfe einer nicht unterstützten Komprimierungsmethode komprimiert.
Hinweise
Das angegebene Verzeichnis darf nicht vorhanden sein. Der Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
