TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) Methode

Definition

Namespace:

System.Formats.Tar

Assembly:

System.Formats.Tar.dll

Quelle:

TarEntry.cs

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.Task

Public Function ExtractToFileAsync (destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

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

Task

Eine Aufgabe, die den asynchronen Extraktionsvorgang darstellt.

Ausnahmen

ArgumentNullException

destinationFileName ist null.

ArgumentException

destinationFileName ist leer.

IOException

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.

InvalidOperationException

Der Eintragstyp wird nicht unterstützt.

UnauthorizedAccessException

Die Berechtigungen reichen nicht aus.

OperationCanceledException

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).