TarFile.ExtractToDirectoryAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| ExtractToDirectoryAsync(String, String, Boolean, CancellationToken) |
tar ファイルの内容を指定したディレクトリに非同期的に抽出します。 |
| ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken) |
tar アーカイブを表すストリームの内容を、指定されたディレクトリに非同期的に抽出します。 |
| ExtractToDirectoryAsync(Stream, String, TarExtractOptions, CancellationToken) | |
| ExtractToDirectoryAsync(String, String, TarExtractOptions, CancellationToken) |
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)
- ソース:
- TarFile.cs
- ソース:
- TarFile.cs
- ソース:
- TarFile.cs
- ソース:
- TarFile.cs
- ソース:
- 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.TaskPublic 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 です。
返品
非同期抽出操作を表すタスク。
例外
sourceFileName または destinationDirectoryName が null。
destinationDirectoryName ディレクトリ パスが見つかりません。
sourceFileName ファイル パスが見つかりません。
アクセス許可が不十分です。
tar エントリの 1 つを抽出すると、指定した宛先ディレクトリの外部にファイルが生成されます。
-又は-
sourceFileName または destinationDirectoryName が空です。
.NET 11 以降のバージョンのみ: エントリのチェックサムが無効です。
I/O 例外が発生しました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
tar アーカイブ内のシンボリック リンクまたはジャンクションにより、指定した destinationDirectoryNameの外部でファイルが抽出された場合、抽出が同じディレクトリ内に残ることを保証するために IOException がスローされます。
destinationDirectoryNameまたはその親ディレクトリのいずれかが既存のジャンクションまたはシンボリック リンクである場合、リンクがフォローされ、抽出によって最終的なターゲット フォルダーに書き込まれます。
BlockDevice、CharacterDevice、またはFifoの種類のファイルは、Unix プラットフォームでのみ抽出できます。
ディスクに BlockDevice または CharacterDevice を抽出するには、昇格が必要です。
このメソッドでは、抽出された合計サイズやアーカイブから抽出されたエントリの数は制限されません。 信頼されていないソースからのアーカイブを処理する場合は、 TarReaderを使用してエントリを手動で反復処理し、サイズとエントリの数がシナリオで許容できる制限内にあることを検証します。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 ExtractToDirectory(String, String, Boolean)によってスローされる例外を参照してください。
適用対象
ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)
- ソース:
- TarFile.cs
- ソース:
- TarFile.cs
- ソース:
- TarFile.cs
- ソース:
- TarFile.cs
- ソース:
- 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.TaskPublic 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 です。
返品
非同期抽出操作を表すタスク。
例外
source または destinationDirectoryName が null。
destinationDirectoryName ディレクトリ パスが見つかりません。
アクセス許可が不十分です。
tar エントリの 1 つを抽出すると、指定した宛先ディレクトリの外部にファイルが生成されます。
-又は-
destinationDirectoryName が空です。
-又は-
source は読み取りをサポートしていません。
.NET 11 以降のバージョンのみ: エントリのチェックサムが無効です。
I/O 例外が発生しました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
tar アーカイブ内のシンボリック リンクまたはジャンクションにより、指定した destinationDirectoryNameの外部でファイルが抽出された場合、抽出が同じディレクトリ内に残ることを保証するために IOException がスローされます。
destinationDirectoryNameまたはその親ディレクトリのいずれかが既存のジャンクションまたはシンボリック リンクである場合、リンクがフォローされ、抽出によって最終的なターゲット フォルダーに書き込まれます。
BlockDevice、CharacterDevice、またはFifoの種類のファイルは、Unix プラットフォームでのみ抽出できます。
ディスクに BlockDevice または CharacterDevice を抽出するには、昇格が必要です。
このメソッドでは、抽出された合計サイズやアーカイブから抽出されたエントリの数は制限されません。 信頼されていないソースからのアーカイブを処理する場合は、 TarReaderを使用してエントリを手動で反復処理し、サイズとエントリの数がシナリオで許容できる制限内にあることを検証します。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 ExtractToDirectory(Stream, String, Boolean)によってスローされる例外を参照してください。
適用対象
ExtractToDirectoryAsync(Stream, String, TarExtractOptions, CancellationToken)
- ソース:
- TarFile.cs
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Formats.Tar.TarExtractOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, options As TarExtractOptions, Optional cancellationToken As CancellationToken = Nothing) As Taskパラメーター
- source
- Stream
- destinationDirectoryName
- String
- options
- TarExtractOptions
- cancellationToken
- CancellationToken
返品
適用対象
ExtractToDirectoryAsync(String, String, TarExtractOptions, CancellationToken)
- ソース:
- TarFile.cs
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceFileName, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.Formats.Tar.TarExtractOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions, Optional cancellationToken As CancellationToken = Nothing) As Taskパラメーター
- sourceFileName
- String
- destinationDirectoryName
- String
- options
- TarExtractOptions
- cancellationToken
- CancellationToken
