ZipFile.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(String, String, Boolean, CancellationToken) |
Extrahiert asynchron alle Dateien im angegebenen Archiv in ein Verzeichnis im Dateisystem. |
| ExtractToDirectoryAsync(Stream, String, CancellationToken) |
Extrahiert asynchron alle Dateien aus dem zip-Archiv, das im angegebenen Datenstrom gespeichert ist, und platziert sie im angegebenen Zielverzeichnis im Dateisystem. |
| ExtractToDirectoryAsync(String, String, CancellationToken) |
Extrahiert asynchron alle Dateien im angegebenen Archiv in ein Verzeichnis im Dateisystem. |
| ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken) |
Extrahiert asynchron alle Dateien aus dem zip-Archiv, das im angegebenen Datenstrom gespeichert ist, und platziert sie im angegebenen Zielverzeichnis im Dateisystem und ermöglicht optional die Auswahl, ob die Dateien im Zielverzeichnis überschrieben werden sollen. |
| ExtractToDirectoryAsync(Stream, String, Encoding, CancellationToken) |
Extrahiert asynchron alle Dateien aus dem zip-Archiv, das im angegebenen Datenstrom gespeichert ist, und platziert sie im angegebenen Zielverzeichnis im Dateisystem und verwendet die angegebene Zeichencodierung für Eintragsnamen. |
| ExtractToDirectoryAsync(String, String, Encoding, CancellationToken) |
Extrahiert asynchron alle Dateien im angegebenen Archiv in ein Verzeichnis im Dateisystem. |
| ExtractToDirectoryAsync(Stream, String, Encoding, Boolean, CancellationToken) |
Extrahiert asynchron alle Dateien aus dem zip-Archiv, das im angegebenen Datenstrom gespeichert ist, und platziert sie im angegebenen Zielverzeichnis im Dateisystem, verwendet die angegebene Zeichencodierung für Eintragsnamen und ermöglicht optional die Auswahl, ob die Dateien im Zielverzeichnis überschrieben werden sollen. |
| ExtractToDirectoryAsync(String, String, Encoding, Boolean, CancellationToken) |
Extrahiert asynchron alle Dateien im angegebenen Archiv in ein Verzeichnis im Dateisystem. Das angegebene Verzeichnis darf nicht vorhanden sein. Diese Methode erstellt 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 zum destinationDirectoryName hat wie der Eintrag zum Archiv. Der Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert. 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. |
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)
- Quelle:
- ZipFile.Extract.Async.cs
- Quelle:
- ZipFile.Extract.Async.cs
Extrahiert asynchron alle Dateien im angegebenen Archiv in ein Verzeichnis im Dateisystem.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- sourceArchiveFileName
- String
Der Pfad zum Archiv im Dateisystem, das extrahiert werden soll.
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien platziert werden sollen, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- overwriteFiles
- Boolean
true um Dateien zu überschreiben; false Andernfalls.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
sourceArchiveFileName oder destinationDirectoryName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
sourceArchiveFileName oder destinationDirectoryName ist null.
sourceArchiveFileName oder destinationDirectoryName gibt einen Pfad, Dateinamen oder beides an, der die vom System definierte maximale Länge überschreitet. Auf Windows-basierten Plattformen müssen Pfade beispielsweise kleiner als 248 Zeichen sein, und Dateinamen müssen kleiner als 260 Zeichen sein.
Der durch sourceArchiveFileName oder destinationDirectoryName ist ungültige Pfad (z. B. auf einem nicht zugeordneten Laufwerk).
Ein E/A-Fehler ist aufgetreten.
- oder -
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 würde zu einem Dateiziel führen, das sich außerhalb des Zielverzeichnisses befindet (z. B. wegen übergeordneter Verzeichniszugriffer).
- oder -
Ein Archiveintrag hat denselben Namen wie ein bereits extrahierter Eintrag aus demselben Archiv.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
sourceArchiveFileName oder destinationDirectoryName weist ein ungültiges Format auf.
sourceArchiveFileName wurde nicht gefunden.
sourceArchiveFileName kein gültiges ZipArchive.
- oder -
Ein Archiveintrag wurde nicht gefunden oder 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. Diese Methode erstellt 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 den gleichen relativen Pfad zum destinationDirectoryName Archiv hat wie der Eintrag. Der Pfad akzeptiert relative oder absolute Pfadinformationen; Relative Pfade werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
Wenn eine zu archivierende Datei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste Datum und die erste Uhrzeit im ZIP-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet.
Warnung
Diese Methode beschränkt nicht die gesamt unkomprimierte Größe oder die Anzahl der aus dem Archiv extrahierten Einträge. Bei der Verarbeitung von Archiven aus nicht vertrauenswürdigen Quellen durchlaufen Sie die Einträge manuell, ZipArchiveund überprüfen Sie, ob die Gesamtgröße der nicht komprimierten Elemente und die Anzahl der Einträge innerhalb akzeptabler Grenzwerte für Ihr Szenario liegen.
Gilt für:
ExtractToDirectoryAsync(Stream, String, CancellationToken)
- Quelle:
- ZipFile.Extract.Async.cs
- Quelle:
- ZipFile.Extract.Async.cs
Extrahiert asynchron alle Dateien aus dem zip-Archiv, das im angegebenen Datenstrom gespeichert ist, und platziert sie im angegebenen Zielverzeichnis im Dateisystem.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- source
- Stream
Der Datenstrom, aus dem das ZIP-Archiv extrahiert werden soll.
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien platziert werden sollen, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
destinationDirectoryName ist Empty, enthält nur Leerzeichen oder mindestens ein ungültiges Zeichen.
destinationDirectoryName oder source ist null.
Der angegebene Pfad destinationDirectoryName überschreitet die vom System definierte maximale Länge.
Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Der Name eines Eintrags im Archiv ist Empty, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen.
- oder -
Durch das Extrahieren eines Archiveintrags würde eine Datei erstellt, die sich außerhalb des durch destinationDirectoryName. (Dies kann z. B. passieren, wenn der Eintragsname übergeordnete Verzeichnisaccessoren enthält.)
- oder -
Ein zu extrahierener Archiveintrag hat denselben Namen wie ein bereits extrahierter Oder vorhandener destinationDirectoryNameEintrag.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung für den Zugriff auf das Archiv oder das Zielverzeichnis.
destinationDirectoryName enthält ein ungültiges Format.
Das im source Datenstrom enthaltene Archiv ist kein gültiges ZIP-Archiv.
- oder -
Ein Archiveintrag wurde nicht gefunden oder beschädigt.
- oder -
Ein Archiveintrag wurde mithilfe einer nicht unterstützten Komprimierungsmethode komprimiert.
Ein asynchroner Vorgang wird abgebrochen.
Hinweise
Diese Methode erstellt das angegebene Verzeichnis und alle Unterverzeichnisse. Das Zielverzeichnis kann nicht bereits vorhanden sein. Ausnahmen im Zusammenhang mit der Überprüfung der Pfade in den destinationDirectoryName Dateien im ZIP-Archiv, die in den source Parametern enthalten sind, werden vor der Extraktion ausgelöst. Andernfalls bleibt das Archiv teilweise extrahiert, wenn während der Extraktion ein Fehler auftritt. Jede extrahierte Datei hat denselben relativen Pfad zum Verzeichnis, das durch destinationDirectoryName den Quelleintrag angegeben wird, zum Stammverzeichnis des Archivs.
Wenn eine zu archivierende Datei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste Datum und die erste Uhrzeit im ZIP-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet.
Warnung
Diese Methode beschränkt nicht die gesamt unkomprimierte Größe oder die Anzahl der aus dem Archiv extrahierten Einträge. Bei der Verarbeitung von Archiven aus nicht vertrauenswürdigen Quellen durchlaufen Sie die Einträge manuell, ZipArchiveund überprüfen Sie, ob die Gesamtgröße der nicht komprimierten Elemente und die Anzahl der Einträge innerhalb akzeptabler Grenzwerte für Ihr Szenario liegen.
Gilt für:
ExtractToDirectoryAsync(String, String, CancellationToken)
- Quelle:
- ZipFile.Extract.Async.cs
- Quelle:
- ZipFile.Extract.Async.cs
Extrahiert asynchron alle Dateien im angegebenen Archiv in ein Verzeichnis im Dateisystem.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- sourceArchiveFileName
- String
Der Pfad zum Archiv im Dateisystem, das extrahiert werden soll.
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien platziert werden sollen, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
sourceArchiveFileName oder destinationDirectoryName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
sourceArchiveFileName oder destinationDirectoryName ist null.
sourceArchiveFileName oder destinationDirectoryName gibt einen Pfad, Dateinamen oder beides an, der die vom System definierte maximale Länge überschreitet. Auf Windows-basierten Plattformen müssen Pfade beispielsweise kleiner als 248 Zeichen sein, und Dateinamen müssen kleiner als 260 Zeichen sein.
Der durch sourceArchiveFileName oder destinationDirectoryName ist ungültige Pfad (z. B. auf einem nicht zugeordneten Laufwerk).
Ein E/A-Fehler ist aufgetreten.
- oder -
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 würde zu einem Dateiziel führen, das sich außerhalb des Zielverzeichnisses befindet (z. B. wegen übergeordneter Verzeichniszugriffer).
- oder -
Ein Archiveintrag hat denselben Namen wie ein bereits extrahierter Eintrag aus demselben Archiv.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
sourceArchiveFileName oder destinationDirectoryName weist ein ungültiges Format auf.
sourceArchiveFileName wurde nicht gefunden.
Das angegebene sourceArchiveFileName Archiv ist kein gültiges ZipArchive.
- oder -
Ein Archiveintrag wurde nicht gefunden oder 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. Diese Methode erstellt 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 den gleichen relativen Pfad zum destinationDirectoryName Archiv hat wie der Eintrag. Der Pfad akzeptiert relative oder absolute Pfadinformationen; Relative Pfade werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
Wenn eine zu archivierende Datei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste Datum und die erste Uhrzeit im ZIP-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet.
Warnung
Diese Methode beschränkt nicht die gesamt unkomprimierte Größe oder die Anzahl der aus dem Archiv extrahierten Einträge. Bei der Verarbeitung von Archiven aus nicht vertrauenswürdigen Quellen durchlaufen Sie die Einträge manuell, ZipArchiveund überprüfen Sie, ob die Gesamtgröße der nicht komprimierten Elemente und die Anzahl der Einträge innerhalb akzeptabler Grenzwerte für Ihr Szenario liegen.
Gilt für:
ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)
- Quelle:
- ZipFile.Extract.Async.cs
- Quelle:
- ZipFile.Extract.Async.cs
Extrahiert asynchron alle Dateien aus dem zip-Archiv, das im angegebenen Datenstrom gespeichert ist, und platziert sie im angegebenen Zielverzeichnis im Dateisystem und ermöglicht optional die Auswahl, ob die Dateien im Zielverzeichnis überschrieben werden sollen.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- source
- Stream
Der Datenstrom, aus dem das ZIP-Archiv extrahiert werden soll.
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien platziert werden sollen, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- 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 Empty, enthält nur Leerzeichen oder mindestens ein ungültiges Zeichen.
destinationDirectoryName oder source ist null.
Der angegebene Pfad destinationDirectoryName überschreitet die vom System definierte maximale Länge.
Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Der Name eines Eintrags im Archiv ist Empty, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen.
- oder -
Durch das Extrahieren eines Archiveintrags würde eine Datei erstellt, die sich außerhalb des durch destinationDirectoryName. (Dies kann z. B. passieren, wenn der Eintragsname übergeordnete Verzeichnisaccessoren enthält.)
- oder -
overwriteFiles ist false und ein Archiveintrag zum Extrahieren denselben Namen wie ein Bereits extrahierter Eintrag hat oder in destinationDirectoryNamedem vorhanden ist.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung für den Zugriff auf das Archiv oder das Zielverzeichnis.
destinationDirectoryName enthält ein ungültiges Format.
Das im source Datenstrom enthaltene Archiv ist kein gültiges ZIP-Archiv.
- oder -
Ein Archiveintrag wurde nicht gefunden oder beschädigt.
- oder -
Ein Archiveintrag wurde mithilfe einer nicht unterstützten Komprimierungsmethode komprimiert.
Ein asynchroner Vorgang wird abgebrochen.
Hinweise
Diese Methode erstellt das angegebene Verzeichnis und alle Unterverzeichnisse. Das Zielverzeichnis kann nicht bereits vorhanden sein. Ausnahmen im Zusammenhang mit der Überprüfung der Pfade in den destinationDirectoryName Dateien im ZIP-Archiv, die in den source Parametern enthalten sind, werden vor der Extraktion ausgelöst. Andernfalls bleibt das Archiv teilweise extrahiert, wenn während der Extraktion ein Fehler auftritt. Jede extrahierte Datei hat denselben relativen Pfad zum Verzeichnis, das durch destinationDirectoryName den Quelleintrag angegeben wird, zum Stammverzeichnis des Archivs.
Wenn eine zu archivierende Datei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste Datum und die erste Uhrzeit im ZIP-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet.
Warnung
Diese Methode beschränkt nicht die gesamt unkomprimierte Größe oder die Anzahl der aus dem Archiv extrahierten Einträge. Bei der Verarbeitung von Archiven aus nicht vertrauenswürdigen Quellen durchlaufen Sie die Einträge manuell, ZipArchiveund überprüfen Sie, ob die Gesamtgröße der nicht komprimierten Elemente und die Anzahl der Einträge innerhalb akzeptabler Grenzwerte für Ihr Szenario liegen.
Gilt für:
ExtractToDirectoryAsync(Stream, String, Encoding, CancellationToken)
- Quelle:
- ZipFile.Extract.Async.cs
- Quelle:
- ZipFile.Extract.Async.cs
Extrahiert asynchron alle Dateien aus dem zip-Archiv, das im angegebenen Datenstrom gespeichert ist, und platziert sie im angegebenen Zielverzeichnis im Dateisystem und verwendet die angegebene Zeichencodierung für Eintragsnamen.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- source
- Stream
Der Datenstrom, aus dem das ZIP-Archiv extrahiert werden soll.
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien platziert werden sollen, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- entryNameEncoding
- Encoding
Die Codierung, die beim Lesen oder Schreiben von Eintragsnamen und Kommentaren in diesem Archiv verwendet werden soll. Geben Sie einen Wert für diesen Parameter nur an, wenn eine Codierung für die Interoperabilität mit ZIP-Archivtools und -bibliotheken erforderlich ist, die utf-8-Codierung für Eintragsnamen oder Kommentare nicht unterstützen.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
destinationDirectoryName ist Empty, enthält nur Leerzeichen oder mindestens ein ungültiges Zeichen.
- oder -
entryNameEncoding ist auf eine andere Unicode-Codierung als UTF-8 festgelegt.
destinationDirectoryName oder source ist null.
Der angegebene Pfad destinationDirectoryName überschreitet die vom System definierte maximale Länge.
Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Der Name eines Eintrags im Archiv ist Empty, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen.
- oder -
Durch das Extrahieren eines Archiveintrags würde eine Datei erstellt, die sich außerhalb des durch destinationDirectoryName. (Dies kann z. B. passieren, wenn der Eintragsname übergeordnete Verzeichnisaccessoren enthält.)
- oder -
Ein zu extrahierener Archiveintrag hat denselben Namen wie ein bereits extrahierter Oder vorhandener destinationDirectoryNameEintrag.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung für den Zugriff auf das Archiv oder das Zielverzeichnis.
destinationDirectoryName enthält ein ungültiges Format.
Das im source Datenstrom enthaltene Archiv ist kein gültiges ZIP-Archiv.
- oder -
Ein Archiveintrag wurde nicht gefunden oder beschädigt.
- oder -
Ein Archiveintrag wurde mithilfe einer nicht unterstützten Komprimierungsmethode komprimiert.
Ein asynchroner Vorgang wird abgebrochen.
Hinweise
Diese Methode erstellt das angegebene Verzeichnis und alle Unterverzeichnisse. Das Zielverzeichnis kann nicht bereits vorhanden sein. Ausnahmen im Zusammenhang mit der Überprüfung der Pfade in den destinationDirectoryName Dateien im ZIP-Archiv, die in den source Parametern enthalten sind, werden vor der Extraktion ausgelöst. Andernfalls bleibt das Archiv teilweise extrahiert, wenn während der Extraktion ein Fehler auftritt. Jede extrahierte Datei hat denselben relativen Pfad zum Verzeichnis, das durch destinationDirectoryName den Quelleintrag angegeben wird, zum Stammverzeichnis des Archivs.
Wenn eine zu archivierende Datei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste Datum und die erste Uhrzeit im ZIP-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet.
Warnung
Diese Methode beschränkt nicht die gesamt unkomprimierte Größe oder die Anzahl der aus dem Archiv extrahierten Einträge. Bei der Verarbeitung von Archiven aus nicht vertrauenswürdigen Quellen durchlaufen Sie die Einträge manuell, ZipArchiveund überprüfen Sie, ob die Gesamtgröße der nicht komprimierten Elemente und die Anzahl der Einträge innerhalb akzeptabler Grenzwerte für Ihr Szenario liegen.
Gilt für:
ExtractToDirectoryAsync(String, String, Encoding, CancellationToken)
- Quelle:
- ZipFile.Extract.Async.cs
- Quelle:
- ZipFile.Extract.Async.cs
Extrahiert asynchron alle Dateien im angegebenen Archiv in ein Verzeichnis im Dateisystem.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- sourceArchiveFileName
- String
Der Pfad zum Archiv im Dateisystem, das extrahiert werden soll.
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis im Dateisystem. Das angegebene Verzeichnis darf nicht vorhanden sein, aber das Verzeichnis, in dem es enthalten ist, muss vorhanden sein.
- entryNameEncoding
- Encoding
Die Codierung, die beim Lesen oder Schreiben von Eintragsnamen und Kommentaren in dieser ZipArchive verwendet werden soll.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
sourceArchiveFileName oder destinationDirectoryName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
sourceArchiveFileName oder destinationDirectoryName ist null.
sourceArchiveFileName oder destinationDirectoryName gibt einen Pfad, Dateinamen oder beides an, der die vom System definierte maximale Länge überschreitet. Auf Windows-basierten Plattformen müssen Pfade beispielsweise kleiner als 248 Zeichen sein, und Dateinamen müssen kleiner als 260 Zeichen sein.
Der durch sourceArchiveFileName oder destinationDirectoryName ist ungültige Pfad (z. B. auf einem nicht zugeordneten Laufwerk).
Ein E/A-Fehler ist aufgetreten.
- oder -
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 würde zu einem Dateiziel führen, das sich außerhalb des Zielverzeichnisses befindet (z. B. wegen übergeordneter Verzeichniszugriffer).
- oder -
Ein Archiveintrag hat denselben Namen wie ein bereits extrahierter Eintrag aus demselben Archiv.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
sourceArchiveFileName oder destinationDirectoryName weist ein ungültiges Format auf.
sourceArchiveFileName wurde nicht gefunden.
Das angegebene sourceArchiveFileName Archiv ist kein gültiges ZipArchive.
- oder -
Ein Archiveintrag wurde nicht gefunden oder 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. Diese Methode erstellt 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 den gleichen relativen Pfad zum destinationDirectoryName Archiv hat wie der Eintrag. Der Pfad akzeptiert relative oder absolute Pfadinformationen; Relative Pfade werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
Wenn eine zu archivierende Datei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste Datum und die erste Uhrzeit im ZIP-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet.
Wenn entryNameEncoding dieser Wert auf einen anderen Wert festgelegt ist, nullwerden Eintragsnamen und Kommentare gemäß den folgenden Regeln decodiert:
- Verwenden Sie für Einträge, bei denen das Sprachcodierungskennzeichnungs-Flag (EFS) im allgemeinen Bit-Flag des lokalen Dateiheaders nicht festgelegt ist, den angegebenen
entryNameEncodingCode, um den Eintragsnamen und den Kommentar zu decodieren. - Verwenden Sie für Einträge, bei denen die Sprachcodierungskennzeichnung (LANGUAGE Encoding Flag, EFS) im allgemeinen Bit-Flag des lokalen Dateiheaders festgelegt ist, UTF-8 (
Encoding.UTF8) zum Decodieren des Eintragsnamens und des Kommentars.
Ist entryNameEncoding diese Eigenschaft auf null", werden Eintragsnamen und Kommentare gemäß den folgenden Regeln decodiert:
- Verwenden Sie für Einträge, bei denen das Sprachcodierungskennzeichnungs-Flag (EFS) im allgemeinen Bit-Flag des lokalen Dateiheaders nicht festgelegt ist, die aktuelle Standardcodeseite (
Encoding.Default) des Systems, um den Eintragsnamen und den Kommentar zu decodieren. - Verwenden Sie für Einträge, bei denen die Sprachcodierungskennzeichnung (LANGUAGE Encoding Flag, EFS) im allgemeinen Bit-Flag des lokalen Dateiheaders festgelegt ist, UTF-8 (
Encoding.UTF8) zum Decodieren des Eintragsnamens und des Kommentars.
Andere Unicode-Codierungen als UTF-8 können nicht verwendet entryNameEncodingwerden, andernfalls wird ein ArgumentException Fehler ausgelöst.
Warnung
Diese Methode beschränkt nicht die gesamt unkomprimierte Größe oder die Anzahl der aus dem Archiv extrahierten Einträge. Bei der Verarbeitung von Archiven aus nicht vertrauenswürdigen Quellen durchlaufen Sie die Einträge manuell, ZipArchiveund überprüfen Sie, ob die Gesamtgröße der nicht komprimierten Elemente und die Anzahl der Einträge innerhalb akzeptabler Grenzwerte für Ihr Szenario liegen.
Gilt für:
ExtractToDirectoryAsync(Stream, String, Encoding, Boolean, CancellationToken)
- Quelle:
- ZipFile.Create.cs
- Quelle:
- ZipFile.Create.cs
Extrahiert asynchron alle Dateien aus dem zip-Archiv, das im angegebenen Datenstrom gespeichert ist, und platziert sie im angegebenen Zielverzeichnis im Dateisystem, verwendet die angegebene Zeichencodierung für Eintragsnamen und ermöglicht optional die Auswahl, ob die Dateien im Zielverzeichnis überschrieben werden sollen.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Text.Encoding * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- source
- Stream
Der Datenstrom, aus dem das ZIP-Archiv extrahiert werden soll.
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien platziert werden sollen, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- entryNameEncoding
- Encoding
Die Codierung, die beim Lesen oder Schreiben von Eintragsnamen und Kommentaren in diesem Archiv verwendet werden soll. Geben Sie einen Wert für diesen Parameter nur an, wenn eine Codierung für die Interoperabilität mit ZIP-Archivtools und -bibliotheken erforderlich ist, die utf-8-Codierung für Eintragsnamen oder Kommentare nicht unterstützen.
- 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 Empty, enthält nur Leerzeichen oder mindestens ein ungültiges Zeichen.
- oder -
entryNameEncoding ist auf eine andere Unicode-Codierung als UTF-8 festgelegt.
destinationDirectoryName oder source ist null.
Der angegebene Pfad destinationDirectoryName überschreitet die vom System definierte maximale Länge.
Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Der Name eines Eintrags im Archiv ist Empty, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen.
- oder -
Durch das Extrahieren eines Archiveintrags würde eine Datei erstellt, die sich außerhalb des durch destinationDirectoryName. (Dies kann z. B. passieren, wenn der Eintragsname übergeordnete Verzeichnisaccessoren enthält.)
- oder -
overwriteFiles ist false und ein Archiveintrag zum Extrahieren denselben Namen wie ein Bereits extrahierter Eintrag hat oder in destinationDirectoryNamedem vorhanden ist.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung für den Zugriff auf das Archiv oder das Zielverzeichnis.
destinationDirectoryName enthält ein ungültiges Format.
Das im source Datenstrom enthaltene Archiv ist kein gültiges ZIP-Archiv.
- oder -
Ein Archiveintrag wurde nicht gefunden oder beschädigt.
- oder -
Ein Archiveintrag wurde mithilfe einer nicht unterstützten Komprimierungsmethode komprimiert.
Ein asynchroner Vorgang wird abgebrochen.
Hinweise
Diese Methode erstellt das angegebene Verzeichnis und alle Unterverzeichnisse. Das Zielverzeichnis kann nicht bereits vorhanden sein. Ausnahmen im Zusammenhang mit der Überprüfung der Pfade in den destinationDirectoryName Dateien im ZIP-Archiv, die in den source Parametern enthalten sind, werden vor der Extraktion ausgelöst. Andernfalls bleibt das Archiv teilweise extrahiert, wenn während der Extraktion ein Fehler auftritt. Jede extrahierte Datei hat denselben relativen Pfad zum Verzeichnis, das durch destinationDirectoryName den Quelleintrag angegeben wird, zum Stammverzeichnis des Archivs.
Wenn eine zu archivierende Datei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste Datum und die erste Uhrzeit im ZIP-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet.
Warnung
Diese Methode beschränkt nicht die gesamt unkomprimierte Größe oder die Anzahl der aus dem Archiv extrahierten Einträge. Bei der Verarbeitung von Archiven aus nicht vertrauenswürdigen Quellen durchlaufen Sie die Einträge manuell, ZipArchiveund überprüfen Sie, ob die Gesamtgröße der nicht komprimierten Elemente und die Anzahl der Einträge innerhalb akzeptabler Grenzwerte für Ihr Szenario liegen.
Gilt für:
ExtractToDirectoryAsync(String, String, Encoding, Boolean, CancellationToken)
- Quelle:
- ZipFile.Create.cs
- Quelle:
- ZipFile.Create.cs
Extrahiert asynchron alle Dateien im angegebenen Archiv in ein Verzeichnis im Dateisystem.
Das angegebene Verzeichnis darf nicht vorhanden sein. Diese Methode erstellt 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 zum destinationDirectoryName hat wie der Eintrag zum Archiv. Der Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert. 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.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.Text.Encoding * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- sourceArchiveFileName
- String
Der Pfad zum Archiv im Dateisystem, das extrahiert werden soll.
- destinationDirectoryName
- String
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien platziert werden sollen, angegeben als relativer oder absoluter Pfad. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- entryNameEncoding
- Encoding
Die Codierung, die beim Lesen oder Schreiben von Eintragsnamen und Kommentaren in dieser ZipArchive verwendet werden soll.
- overwriteFiles
- Boolean
true um Dateien zu überschreiben; false Andernfalls.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
sourceArchiveFileName oder destinationDirectoryName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
sourceArchiveFileName oder destinationDirectoryName ist null.
sourceArchiveFileName oder destinationDirectoryName gibt einen Pfad, Dateinamen oder beides an, der die vom System definierte maximale Länge überschreitet. Auf Windows-basierten Plattformen müssen Pfade beispielsweise kleiner als 248 Zeichen sein, und Dateinamen müssen kleiner als 260 Zeichen sein.
Der durch sourceArchiveFileName oder destinationDirectoryName ist ungültige Pfad (z. B. auf einem nicht zugeordneten Laufwerk).
Ein E/A-Fehler ist aufgetreten.
- oder -
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 würde zu einem Dateiziel führen, das sich außerhalb des Zielverzeichnisses befindet (z. B. wegen übergeordneter Verzeichniszugriffer).
- oder -
Ein Archiveintrag hat denselben Namen wie ein bereits extrahierter Eintrag aus demselben Archiv.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
sourceArchiveFileName oder destinationDirectoryName weist ein ungültiges Format auf.
sourceArchiveFileName wurde nicht gefunden.
Das angegebene sourceArchiveFileName Archiv ist kein gültiges ZipArchive.
- oder -
Ein Archiveintrag wurde nicht gefunden oder beschädigt.
- oder -
Ein Archiveintrag wurde mithilfe einer nicht unterstützten Komprimierungsmethode komprimiert.
Ein asynchroner Vorgang wird abgebrochen.
Hinweise
Wenn entryNameEncoding dieser Wert auf einen anderen Wert festgelegt ist, nullwerden Eintragsnamen und Kommentare gemäß den folgenden Regeln decodiert:
- Verwenden Sie für Einträge, bei denen das Sprachcodierungskennzeichnungs-Flag (EFS) im allgemeinen Bit-Flag des lokalen Dateiheaders nicht festgelegt ist, den angegebenen
entryNameEncodingCode, um den Eintragsnamen und den Kommentar zu decodieren. - Verwenden Sie für Einträge, bei denen die Sprachcodierungskennzeichnung (LANGUAGE Encoding Flag, EFS) im allgemeinen Bit-Flag des lokalen Dateiheaders festgelegt ist, UTF-8 (
Encoding.UTF8) zum Decodieren des Eintragsnamens und des Kommentars.
Ist entryNameEncoding diese Eigenschaft auf null", werden Eintragsnamen und Kommentare gemäß den folgenden Regeln decodiert:
- Verwenden Sie für Einträge, bei denen das Sprachcodierungskennzeichnungs-Flag (EFS) im allgemeinen Bit-Flag des lokalen Dateiheaders nicht festgelegt ist, die aktuelle Standardcodeseite (
Encoding.Default) des Systems, um den Eintragsnamen und den Kommentar zu decodieren. - Verwenden Sie für Einträge, bei denen die Sprachcodierungskennzeichnung (LANGUAGE Encoding Flag, EFS) im allgemeinen Bit-Flag des lokalen Dateiheaders festgelegt ist, UTF-8 (
Encoding.UTF8) zum Decodieren des Eintragsnamens und des Kommentars.
Andere Unicode-Codierungen als UTF-8 können nicht verwendet entryNameEncodingwerden, andernfalls wird ein ArgumentException Fehler ausgelöst.
Warnung
Diese Methode beschränkt nicht die gesamt unkomprimierte Größe oder die Anzahl der aus dem Archiv extrahierten Einträge. Bei der Verarbeitung von Archiven aus nicht vertrauenswürdigen Quellen durchlaufen Sie die Einträge manuell, ZipArchiveund überprüfen Sie, ob die Gesamtgröße der nicht komprimierten Elemente und die Anzahl der Einträge innerhalb akzeptabler Grenzwerte für Ihr Szenario liegen.
