TarFile.CreateFromDirectoryAsync Metoda

Definice

Obor názvů:

System.Formats.Tar

Sestavení:

System.Formats.Tar.dll

Přetížení

CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)	Asynchronně vytvoří datový proud tar, který obsahuje všechny položky systému souborů ze zadaného adresáře.
CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)	Asynchronně vytvoří archiv tar z obsahu zadaného adresáře a vypíše je do zadané cesty. Volitelně může jako předponu názvů položek zahrnout základní adresář.

CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)

Zdroj:

TarFile.cs

Asynchronně vytvoří datový proud tar, který obsahuje všechny položky systému souborů ze zadaného adresáře.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync (string sourceDirectoryName, System.IO.Stream destination, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

sourceDirectoryName

String

Cesta k adresáři, který se má archivovat.

destination

Stream

Cílový stream archivu.

includeBaseDirectory

Boolean

true , aby se název základního adresáře zahrnul jako první segment cesty ve všech názvech archivních položek. false vyloučíte název základního adresáře z cest k názvům položek.

cancellationToken

CancellationToken

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

Návraty

Task

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

Výjimky

ArgumentNullException

sourceDirectoryName nebo destination je null.

ArgumentException

sourceDirectoryName je prázdné.

-nebo-

destination nepodporuje psaní.

DirectoryNotFoundException

Cesta sourceDirectoryName k adresáři nebyla nalezena.

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

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

CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)

Zdroj:

TarFile.cs

Asynchronně vytvoří archiv tar z obsahu zadaného adresáře a vypíše je do zadané cesty. Volitelně může jako předponu názvů položek zahrnout základní adresář.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync (string sourceDirectoryName, string destinationFileName, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationFileName As String, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

sourceDirectoryName

String

Cesta k adresáři, který se má archivovat.

destinationFileName

String

Cesta k cílovému souboru archivu.

includeBaseDirectory

Boolean

true , aby se název základního adresáře zahrnul jako první segment cesty ve všech názvech archivních položek. false vyloučíte název základního adresáře z cest k názvům položek.

cancellationToken

CancellationToken

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

Návraty

Task

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

Výjimky

ArgumentNullException

sourceDirectoryName nebo destinationFileName je null.

ArgumentException

sourceDirectoryName nebo destinationFileName je prázdná.

DirectoryNotFoundException

Cesta sourceDirectoryName k adresáři nebyla nalezena.

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

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