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.
Extrahiert alle Dateien im Archiv in ein Verzeichnis im Dateisystem. Das angegebene Verzeichnis ist möglicherweise bereits vorhanden.
Ü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 kann bereits vorhanden sein. |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
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. Das Verzeichnis kann bereits vorhanden sein. Fehlende Verzeichnisse werden beim Extrahieren von Einträgen nach Bedarf erstellt.
- 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
Warnung
Diese Methode darf nicht zum Extrahieren nicht vertrauenswürdiger Archive verwendet werden. Es erzwingt keine Größenbeschränkungen, Grenzwerte für die Eintragsanzahl oder andere Richtlinien, die für die sichere Extraktion nicht vertrauenswürdiger Archive erforderlich sind. Weitere Informationen zum sicheren Extrahieren von Archiven aus nicht vertrauenswürdigen Quellen finden Sie unter Bewährte Methoden für die Verwendung von ZIP- und Tar-Archiven.
Das von destinationDirectoryName ihnen angegebene Verzeichnis kann bereits vorhanden sein. Diese Methode erstellt das Zielverzeichnis, die fehlenden übergeordneten Verzeichnisse und Unterverzeichnisse bei Bedarf beim Extrahieren von Einträgen. Wenn das Archiv leer ist, erstellt diese Methode nicht das Zielverzeichnis.
Der Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
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 kann bereits vorhanden sein.
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. Das Verzeichnis kann bereits vorhanden sein. Fehlende Verzeichnisse werden beim Extrahieren von Einträgen nach Bedarf erstellt.
- 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.
Mit dieser Methode werden beim Extrahieren von Einträgen fehlende Verzeichnisse erstellt.
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
Warnung
Diese Methode darf nicht zum Extrahieren nicht vertrauenswürdiger Archive verwendet werden. Es erzwingt keine Größenbeschränkungen, Grenzwerte für die Eintragsanzahl oder andere Richtlinien, die für die sichere Extraktion nicht vertrauenswürdiger Archive erforderlich sind. Weitere Informationen zum sicheren Extrahieren von Archiven aus nicht vertrauenswürdigen Quellen finden Sie unter Bewährte Methoden für die Verwendung von ZIP- und Tar-Archiven.
Das von destinationDirectoryName ihnen angegebene Verzeichnis kann bereits vorhanden sein. Diese Methode erstellt das Zielverzeichnis, die fehlenden übergeordneten Verzeichnisse und Unterverzeichnisse bei Bedarf beim Extrahieren von Einträgen. Wenn das Archiv leer ist, erstellt diese Methode nicht das Zielverzeichnis.
Der Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
Gilt für:
ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- source
- ZipArchive
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien platziert werden sollen. Das Verzeichnis kann bereits vorhanden sein. Fehlende Verzeichnisse werden beim Extrahieren von Einträgen nach Bedarf erstellt.
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
Gibt zurück
Hinweise
Warnung
Diese Methode darf nicht zum Extrahieren nicht vertrauenswürdiger Archive verwendet werden. Es erzwingt keine Größenbeschränkungen, Grenzwerte für die Eintragsanzahl oder andere Richtlinien, die für die sichere Extraktion nicht vertrauenswürdiger Archive erforderlich sind. Weitere Informationen zum sicheren Extrahieren von Archiven aus nicht vertrauenswürdigen Quellen finden Sie unter Bewährte Methoden für die Verwendung von ZIP- und Tar-Archiven.
Das von destinationDirectoryName ihnen angegebene Verzeichnis kann bereits vorhanden sein. Diese Methode erstellt das Zielverzeichnis, die fehlenden übergeordneten Verzeichnisse und Unterverzeichnisse bei Bedarf beim Extrahieren von Einträgen. Wenn das Archiv leer ist, erstellt diese Methode nicht das Zielverzeichnis.
Jede extrahierte Datei hat denselben relativen Pfad destinationDirectoryName wie der Quelleintrag zum Stammverzeichnis des Archivs.
Der destinationDirectoryName Parameter akzeptiert relative und absolute Pfade. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.
Wenn während der Extraktion ein Fehler auftritt, bleibt das Archiv teilweise extrahiert.
Legen Sie fest OverwriteFiles , true dass vorhandene Dateien überschrieben werden sollen. Der Standardwert ist false, wodurch die Extraktion ausgelöst IOException wird, wenn bereits eine Datei extrahiert wird.
Wird verwendet Password , um das Kennwort für verschlüsselte Einträge anzugeben.
EntryNameEncoding wird von dieser Überladung nicht verwendet. Eintragsnamen und Kommentare werden mit der beim Öffnen des source Archivs angegebenen Codierung decodiert.
Symbolische Verknüpfungen im Archiv werden nicht als symbolische Verknüpfungen neu erstellt. Wenn destinationDirectoryName es sich bei einem der übergeordneten Verzeichnisse um eine bereits vorhandene Verbindung oder eine symbolische Verknüpfung handelt, wird der Link befolgt und extrahiert in den endgültigen Zielordner geschrieben.
Ausnahmen, die während der asynchronen Extraktion auftreten, werden in der zurückgegebenen Aufgabe gespeichert und ausgelöst, wenn die Aufgabe erwartet wird.
