TarFile.ExtractToDirectoryAsync Metoda

Definice

Obor názvů:

System.Formats.Tar

Sestavení:

System.Formats.Tar.dll

Přetížení

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)	Asynchronně extrahuje obsah datového proudu, který představuje archiv tar do zadaného adresáře.
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)	Asynchronně extrahuje obsah souboru tar do zadaného adresáře.

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)

Zdroj:

TarFile.cs

Asynchronně extrahuje obsah datového proudu, který představuje archiv tar do zadaného adresáře.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync (System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : System.IO.Stream * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

source

Stream

Datový proud obsahující archiv tar.

destinationDirectoryName

String

Cesta k cílovému adresáři, do kterého mají být extrahovány položky systému souborů.

overwriteFiles

Boolean

truek přepsání souborů a adresářů v destinationDirectoryNamefalse , aby se zabránilo přepsání, a vyvolání, pokud jsou nalezeny nějaké soubory nebo adresáře s existujícími názvy.

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

source nebo destinationDirectoryName je null.

DirectoryNotFoundException

Cesta destinationDirectoryName k adresáři nebyla nalezena.

UnauthorizedAccessException

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

ArgumentException

Extrahování jedné z položek tar by vedlo k vytvoření souboru mimo zadaný cílový adresář.

-nebo-

destinationDirectoryName je prázdné.

-nebo-

source nepodporuje čtení.

IOException

Došlo k výjimce vstupně-výstupních operací.

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 ExtractToDirectory(Stream, String, Boolean).

ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)

Zdroj:

TarFile.cs

Asynchronně extrahuje obsah souboru tar do zadaného adresáře.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync (string sourceFileName, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

sourceFileName

String

Cesta k souboru tar, který se má extrahovat.

destinationDirectoryName

String

Cesta k cílovému adresáři, do kterého mají být extrahovány položky systému souborů.

overwriteFiles

Boolean

truek přepsání souborů a adresářů v destinationDirectoryNamefalse , aby se zabránilo přepsání, a vyvolání, pokud jsou nalezeny nějaké soubory nebo adresáře s existujícími názvy.

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

sourceFileName nebo destinationDirectoryName je null.

DirectoryNotFoundException

Cesta destinationDirectoryName k adresáři nebyla nalezena.

FileNotFoundException

Cesta sourceFileName k souboru nebyla nalezena.

UnauthorizedAccessException

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

ArgumentException

Extrahování jedné z položek tar by vedlo k vytvoření souboru mimo zadaný cílový adresář.

-nebo-

sourceFileName nebo destinationDirectoryName je prázdná.

IOException

Došlo k výjimce vstupně-výstupních operací.

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 ExtractToDirectory(String, String, Boolean).