TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) Metoda

Definice

Obor názvů:

System.Formats.Tar

Sestavení:

System.Formats.Tar.dll

Zdroj:

TarEntry.cs

Asynchronně extrahuje aktuální položku do systému souborů.

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

Parametry

destinationFileName

String

Cesta k cílovému souboru.

overwrite

Boolean

true Pokud by tato metoda měla přepsat jakýkoli existující objekt systému souborů umístěný v destinationFileName cestě; false aby se zabránilo přepsání.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Task

Úloha, která představuje operaci asynchronní extrakce.

Výjimky

ArgumentNullException

destinationFileName je null.

ArgumentException

destinationFileName je prázdné.

IOException

Nadřazený adresář pro destinationFileName neexistuje.

-nebo-

overwrite je false a soubor už v destinationFileNamesystému existuje.

-nebo-

Existuje adresář se stejným názvem jako destinationFileName.

-nebo-

Došlo k problému se vstupně-výstupními operacemi.

InvalidOperationException

Typ položky není podporován.

UnauthorizedAccessException

Oprávnění nejsou dostatečná.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Soubory typu BlockDevice, CharacterDevicenebo Fifo lze extrahovat pouze v unixových platformách.

K extrahování BlockDevice nebo CharacterDevice na disk se vyžaduje zvýšení oprávnění.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ExtractToFile(String, Boolean).