ZipFileExtensions.ExtractToFileAsync 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 |
|---|---|
| ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken) |
Erstellt asynchron eine Datei im Dateisystem mit dem Inhalt des Eintrags und dem angegebenen Namen. |
| ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken) |
Erstellt asynchron eine Datei im Dateisystem mit dem Inhalt des Eintrags und dem angegebenen Namen. |
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)
Erstellt asynchron eine Datei im Dateisystem mit dem Inhalt des Eintrags und dem angegebenen Namen.
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- source
- ZipArchiveEntry
Der ZIP-Archiveintrag zum Extrahieren einer Datei aus.
- destinationFileName
- String
Der Name der Datei, die den Inhalt des Eintrags enthält.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
destinationFileName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
-oder-
destinationFileName gibt ein Verzeichnis an.
destinationFileName 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 destinationFileName Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Ein E/A-Fehler ist aufgetreten.
-oder-
Der Eintrag ist zurzeit zum Schreiben geöffnet.
-oder-
Der Eintrag wurde aus dem Archiv gelöscht.
destinationFileName ist in einem ungültigen Format vorhanden.
-oder-
Die ZipArchive, zu der dieser Eintrag gehört, wurde im schreibgeschützten Modus geöffnet.
Der Eintrag fehlt im Archiv oder ist beschädigt und kann nicht gelesen werden.
-oder-
Der Eintrag wurde mit einer nicht unterstützten Komprimierungsmethode komprimiert.
Die ZipArchive, zu der dieser Eintrag gehört, wurde verworfen.
Hinweise
Der angegebene Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
Die letzte Schreibzeit der Datei wird auf die letzte Schreibzeit des Eintrags festgelegt. Diese Methode lässt das Überschreiben einer vorhandenen Datei mit demselben Namen nicht zu. Der Versuch, explizite Verzeichnisse zu extrahieren (Einträge mit Namen, die in Verzeichnistrennzeichen enden) führen nicht zur Erstellung eines Verzeichnisses.
Gilt für:
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)
Erstellt asynchron eine Datei im Dateisystem mit dem Inhalt des Eintrags und dem angegebenen Namen.
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- source
- ZipArchiveEntry
Der ZIP-Archiveintrag zum Extrahieren einer Datei aus.
- destinationFileName
- String
Der Name der Datei, die den Inhalt des Eintrags enthält.
- overwrite
- Boolean
true um Dateien zu überschreiben; false Andernfalls.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
destinationFileName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
-oder-
destinationFileName gibt ein Verzeichnis an.
destinationFileName 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 destinationFileName Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Ein E/A-Fehler ist aufgetreten.
-oder-
Der Eintrag ist zurzeit zum Schreiben geöffnet.
-oder-
Der Eintrag wurde aus dem Archiv gelöscht.
destinationFileName ist in einem ungültigen Format vorhanden.
-oder-
Die ZipArchive, zu der dieser Eintrag gehört, wurde im schreibgeschützten Modus geöffnet.
Der Eintrag fehlt im Archiv oder ist beschädigt und kann nicht gelesen werden.
-oder-
Der Eintrag wurde mit einer nicht unterstützten Komprimierungsmethode komprimiert.
Die ZipArchive, zu der dieser Eintrag gehört, wurde verworfen.
Ein asynchroner Vorgang wird abgebrochen.
Hinweise
Der angegebene Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
Die letzte Schreibzeit der Datei wird auf die letzte Schreibzeit des Eintrags festgelegt.
Diese Methode ermöglicht das Überschreiben einer vorhandenen Datei mit demselben Namen.
