TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
以異步方式將目前的專案解壓縮至文件系統。
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.TaskPublic 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。
傳回
表示異步擷取作業的工作。
例外狀況
destinationFileName 為 null。
destinationFileName 是空的。
的 destinationFileName 父目錄不存在。
-或-
overwrite 是 false ，而且檔案已存在於 中 destinationFileName。
-或-
目錄的名稱與 相同 destinationFileName。
-或-
發生 I/O 問題。
不支援項目類型。
許可權不足。
取消標記已取消。 此例外狀況會儲存在傳回的工作中。
備註
、 或 Fifo 類型的BlockDeviceCharacterDevice檔案只能在 Unix 平臺中擷取。
需要提高許可權才能擷取 BlockDevice 或 CharacterDevice 磁碟。
這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 ExtractToFile(String, Boolean)例外狀況。
