TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) 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 den aktuellen Eintrag asynchron in das Dateisystem.
public System.Threading.Tasks.Task ExtractToFileAsync (string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);member this.ExtractToFileAsync : string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function ExtractToFileAsync (destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- destinationFileName
- String
Der Pfad zur Zieldatei.
- overwrite
- Boolean
true , wenn diese Methode ein vorhandenes Dateisystemobjekt im destinationFileName Pfad überschreiben soll, false um das Überschreiben zu verhindern.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Eine Aufgabe, die den asynchronen Extraktionsvorgang darstellt.
Ausnahmen
destinationFileName ist null.
destinationFileName ist leer.
Das übergeordnete Verzeichnis von destinationFileName ist nicht vorhanden.
Oder
overwriteist und eine Datei bereits in destinationFileNamevorhanden istfalse.
Oder
Ein Verzeichnis mit demselben Namen wie destinationFileNameist vorhanden.
Oder
Ein E/A-Problem ist aufgetreten.
Der Eintragstyp wird nicht unterstützt.
Die Berechtigungen reichen nicht aus.
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 Rechteerweiterung ist erforderlich, um einen BlockDevice oder CharacterDevice auf den Datenträger zu extrahieren.
Diese Methode speichert in der Aufgabe, die 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden ExtractToFile(String, Boolean).
