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 の問題が発生しました。
エントリの種類はサポートされていません。
アクセス許可が不十分です。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
BlockDevice、CharacterDevice、またはFifoの種類のファイルは、Unix プラットフォームでのみ抽出できます。
ディスクに BlockDevice または CharacterDevice を抽出するには、昇格が必要です。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 ExtractToFile(String, Boolean)によってスローされる例外を参照してください。
