TarFile.ExtractToDirectoryAsync 方法

定義

命名空間:

System.Formats.Tar

組件:

System.Formats.Tar.dll

多載

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)	以異步方式將代表 tar 封存的數據流內容擷取到指定的目錄中。
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)	以異步方式將 tar 檔案的內容擷取到指定的目錄中。

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)

來源:

TarFile.cs

以異步方式將代表 tar 封存的數據流內容擷取到指定的目錄中。

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

參數

source

Stream

包含 tar 封存的數據流。

destinationDirectoryName

String

應擷取文件系統專案之目的地目錄的路徑。

overwriteFiles

Boolean

true 表示覆寫 中的 destinationDirectoryName檔案和目錄; false 若要避免覆寫，並在找到任何具有現有名稱的檔案或目錄時擲回 。

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None。

傳回

Task

表示異步擷取作業的工作。

例外狀況

ArgumentNullException

source 或 destinationDirectoryName 為 null。

DirectoryNotFoundException

destinationDirectoryName找不到目錄路徑。

UnauthorizedAccessException

許可權不足。

ArgumentException

擷取其中一個 tar 專案會導致檔案超出指定的目的地目錄。

-或-

destinationDirectoryName 是空的。

-或-

source 不支援讀取。

IOException

發生 I/O 例外狀況。

OperationCanceledException

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

、 或 Fifo 類型的BlockDeviceCharacterDevice檔案只能在 Unix 平臺中擷取。

需要提高許可權才能擷取 BlockDevice 或 CharacterDevice 磁碟。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 ExtractToDirectory(Stream, String, Boolean)例外狀況。

ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)

來源:

TarFile.cs

以異步方式將 tar 檔案的內容擷取到指定的目錄中。

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

參數

sourceFileName

String

要解壓縮之 tar 檔案的路徑。

destinationDirectoryName

String

應擷取文件系統專案之目的地目錄的路徑。

overwriteFiles

Boolean

true 表示覆寫 中的 destinationDirectoryName檔案和目錄; false 若要避免覆寫，並在找到任何具有現有名稱的檔案或目錄時擲回 。

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None。

傳回

Task

表示異步擷取作業的工作。

例外狀況

ArgumentNullException

sourceFileName 或 destinationDirectoryName 為 null。

DirectoryNotFoundException

destinationDirectoryName找不到目錄路徑。

FileNotFoundException

sourceFileName找不到檔案路徑。

UnauthorizedAccessException

許可權不足。

ArgumentException

擷取其中一個 tar 專案會導致檔案超出指定的目的地目錄。

-或-

sourceFileName 或 destinationDirectoryName 是空的。

IOException

發生 I/O 例外狀況。

OperationCanceledException

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

、 或 Fifo 類型的BlockDeviceCharacterDevice檔案只能在 Unix 平臺中擷取。

需要提高許可權才能擷取 BlockDevice 或 CharacterDevice 磁碟。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 ExtractToDirectory(String, String, Boolean)例外狀況。