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 asynchron den aktuellen Eintrag 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 überschreiben soll, das destinationFileName sich im Pfad befindet; false um das Überschreiben zu verhindern.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll. 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 false und eine Datei bereits vorhanden ist.destinationFileName
-oder-
Ein Verzeichnis ist mit demselben Namen vorhanden wie destinationFileName.
-oder-
Ein E/A-Problem ist aufgetreten.
Der Eintragstyp wird nicht unterstützt.
Berechtigungen sind nicht ausreichend.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Dateien vom Typ BlockDevice, CharacterDeviceoder Fifo können nur in Unix-Plattformen extrahiert werden.
Zum Extrahieren einer BlockDevice oder CharacterDevice eines Datenträgers ist eine Erhöhung erforderlich.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von ExtractToFile(String, Boolean).
