TarFile.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
| ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken) |
Extrahiert asynchron den Inhalt eines Datenstroms, der ein Tar-Archiv darstellt, in das angegebene Verzeichnis. |
| ExtractToDirectoryAsync(String, String, Boolean, CancellationToken) |
Extrahiert asynchron den Inhalt einer TAR-Datei in das angegebene Verzeichnis. |
ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)
- Quelle:
- TarFile.cs
- Quelle:
- TarFile.cs
- Quelle:
- TarFile.cs
Extrahiert asynchron den Inhalt eines Datenstroms, der ein Tar-Archiv darstellt, in das angegebene Verzeichnis.
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 Stream, der das Tar-Archiv enthält.
- destinationDirectoryName
- String
Der Pfad des Zielverzeichnisses, in dem die Dateisystemeinträge extrahiert werden sollen.
- overwriteFiles
- Boolean
true , um Dateien und Verzeichnisse in destinationDirectoryNamezu überschreiben, false um Zuschreibungen zu vermeiden und auszulösen, wenn Dateien oder Verzeichnisse mit vorhandenen Namen gefunden werden.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Eine Aufgabe, die den asynchronen Extraktionsvorgang darstellt.
Ausnahmen
source oder destinationDirectoryName ist null.
Der destinationDirectoryName Verzeichnispfad wurde nicht gefunden.
Berechtigungen sind nicht ausreichend.
Das Extrahieren eines der Tar-Einträge hätte zu einer Datei außerhalb des angegebenen Zielverzeichnisses geführt.
- oder -
destinationDirectoryName ist leer.
- oder -
Lesevorgänge werden von source nicht unterstützt.
Es ist eine E/A-Ausnahme aufgetreten.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Dateien vom Typ BlockDevice, CharacterDeviceoder Fifo können nur auf Unix-Plattformen extrahiert werden.
Die Erhöhung ist erforderlich, um einen BlockDevice oder CharacterDevice auf einen Datenträger zu extrahieren.
Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten ExtractToDirectory(Stream, String, Boolean)Ausnahmen.
Gilt für:
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)
- Quelle:
- TarFile.cs
- Quelle:
- TarFile.cs
- Quelle:
- TarFile.cs
Extrahiert asynchron den Inhalt einer TAR-Datei in das angegebene Verzeichnis.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync (string sourceFileName, 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 (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- sourceFileName
- String
Der Pfad der zu extrahierenden tar-Datei.
- destinationDirectoryName
- String
Der Pfad des Zielverzeichnisses, in dem die Dateisystemeinträge extrahiert werden sollen.
- overwriteFiles
- Boolean
true , um Dateien und Verzeichnisse in destinationDirectoryNamezu überschreiben, false um Zuschreibungen zu vermeiden und auszulösen, wenn Dateien oder Verzeichnisse mit vorhandenen Namen gefunden werden.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Eine Aufgabe, die den asynchronen Extraktionsvorgang darstellt.
Ausnahmen
sourceFileName oder destinationDirectoryName ist null.
Der destinationDirectoryName Verzeichnispfad wurde nicht gefunden.
Der sourceFileName Dateipfad wurde nicht gefunden.
Berechtigungen sind nicht ausreichend.
Das Extrahieren eines der Tar-Einträge hätte zu einer Datei außerhalb des angegebenen Zielverzeichnisses geführt.
Oder
sourceFileName oder destinationDirectoryName ist leer.
Es ist eine E/A-Ausnahme aufgetreten.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Dateien vom Typ BlockDevice, CharacterDeviceoder Fifo können nur auf Unix-Plattformen extrahiert werden.
Die Erhöhung ist erforderlich, um einen BlockDevice oder CharacterDevice auf einen Datenträger zu extrahieren.
Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten ExtractToDirectory(String, String, Boolean)Ausnahmen.
