TarFile.ExtractToDirectoryAsync Metoda

Definicja

Przestrzeń nazw:

System.Formats.Tar

Zestaw:

System.Formats.Tar.dll

Przeciążenia

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)	Asynchronicznie wyodrębnia zawartość strumienia reprezentującego archiwum tar do określonego katalogu.
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)	Asynchronicznie wyodrębnia zawartość pliku tar do określonego katalogu.

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)

Źródło:

TarFile.cs

Asynchronicznie wyodrębnia zawartość strumienia reprezentującego archiwum tar do określonego katalogu.

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

Strumień zawierający archiwum tar.

destinationDirectoryName

String

Ścieżka katalogu docelowego, w którym należy wyodrębnić wpisy systemu plików.

overwriteFiles

Boolean

true aby zastąpić pliki i katalogi w pliku destinationDirectoryName; false aby uniknąć zastępowania, i zgłaszać, czy istnieją pliki lub katalogi z istniejącymi nazwami.

cancellationToken

CancellationToken

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

Zwraca

Task

Zadanie reprezentujące operację wyodrębniania asynchronicznego.

Wyjątki

ArgumentNullException

source lub destinationDirectoryName to null.

DirectoryNotFoundException

Nie destinationDirectoryName można odnaleźć ścieżki katalogu.

UnauthorizedAccessException

Uprawnienia są niewystarczające.

ArgumentException

Wyodrębnienie jednego z wpisów tar spowodowałoby, że plik znajduje się poza określonym katalogiem docelowym.

-lub-

destinationDirectoryName jest pusty.

-lub-

source nie obsługuje odczytywania.

IOException

Wystąpił wyjątek we/wy.

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

ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)

Źródło:

TarFile.cs

Asynchronicznie wyodrębnia zawartość pliku tar do określonego katalogu.

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

Ścieżka pliku tar do wyodrębnienia.

destinationDirectoryName

String

Ścieżka katalogu docelowego, w którym należy wyodrębnić wpisy systemu plików.

overwriteFiles

Boolean

true aby zastąpić pliki i katalogi w pliku destinationDirectoryName; false aby uniknąć zastępowania, i zgłaszać, czy istnieją pliki lub katalogi z istniejącymi nazwami.

cancellationToken

CancellationToken

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

Zwraca

Task

Zadanie reprezentujące operację wyodrębniania asynchronicznego.

Wyjątki

ArgumentNullException

sourceFileName lub destinationDirectoryName to null.

DirectoryNotFoundException

Nie destinationDirectoryName można odnaleźć ścieżki katalogu.

FileNotFoundException

Nie sourceFileName można odnaleźć ścieżki pliku.

UnauthorizedAccessException

Uprawnienia są niewystarczające.

ArgumentException

Wyodrębnienie jednego z wpisów tar spowodowałoby, że plik znajduje się poza określonym katalogiem docelowym.

-lub-

sourceFileName lub destinationDirectoryName jest pusty.

IOException

Wystąpił wyjątek we/wy.

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 ExtractToDirectory(String, String, Boolean)usługę .