TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) Metoda

Definicja

Przestrzeń nazw:

System.Formats.Tar

Zestaw:

System.Formats.Tar.dll

Źródło:

TarEntry.cs

Asynchronicznie wyodrębnia bieżący wpis do systemu plików.

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

Ścieżka do pliku docelowego.

overwrite

Boolean

true jeśli ta metoda powinna zastąpić dowolny istniejący obiekt systemu plików znajdujący się w destinationFileName ścieżce, false aby zapobiec zastępowaniu.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Task

Zadanie reprezentujące operację wyodrębniania asynchronicznego.

Wyjątki

ArgumentNullException

destinationFileName to null.

ArgumentException

destinationFileName jest pusty.

IOException

Katalog nadrzędny obiektu destinationFileName nie istnieje.

-lub-

overwrite jest i false plik już istnieje w pliku destinationFileName.

-lub-

Katalog istnieje o takiej samej nazwie jak destinationFileName.

-lub-

Wystąpił problem z we/wy.

InvalidOperationException

Typ wpisu jest nieobsługiwany.

UnauthorizedAccessException

Uprawnienia są niewystarczające.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Pliki typu BlockDevice, CharacterDevicelub Fifo można wyodrębnić tylko na platformach Unix.

Podniesienie uprawnień jest wymagane do wyodrębnienia dysku BlockDevice lub CharacterDevice .

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez ExtractToFile(String, Boolean)usługę .