TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) 方法

定義

命名空間:

System.Formats.Tar

組件:

System.Formats.Tar.dll

來源:

TarEntry.cs

以異步方式將目前的專案解壓縮至文件系統。

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

參數

destinationFileName

String

目的地檔案的路徑。

overwrite

Boolean

true 如果這個方法應該覆寫路徑中 destinationFileName 任何現有的檔系統物件，則為 ， false 以避免覆寫。

cancellationToken

CancellationToken

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

傳回

Task

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

例外狀況

ArgumentNullException

destinationFileName 為 null。

ArgumentException

destinationFileName 是空的。

IOException

的 destinationFileName 父目錄不存在。

-或-

overwrite 是 false ，而且檔案已存在於 中 destinationFileName。

-或-

目錄的名稱與 相同 destinationFileName。

-或-

發生 I/O 問題。

InvalidOperationException

不支援項目類型。

UnauthorizedAccessException

許可權不足。

OperationCanceledException

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

備註

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

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

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