ZipFileExtensions.ExtractToDirectoryAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アーカイブ内のすべてのファイルをファイル システム上のディレクトリに抽出します。 指定したディレクトリが既に存在している可能性があります。
オーバーロード
| 名前 | 説明 |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
アーカイブ内のすべてのファイルをファイル システム上のディレクトリに非同期的に抽出します。 指定したディレクトリは既に存在できます。 |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
アーカイブ内のすべてのファイルをファイル システム上のディレクトリに抽出します。 指定したディレクトリが既に存在している可能性があります。 |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
アーカイブ内のすべてのファイルをファイル システム上のディレクトリに非同期的に抽出します。 指定したディレクトリは既に存在できます。
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As Taskパラメーター
- source
- ZipArchive
ファイルを抽出する zip アーカイブ。
- destinationDirectoryName
- String
ファイル システム上のディレクトリへのパス。
- cancellationToken
- CancellationToken
キャンセル要求を監視するキャンセル トークン。
返品
例外
destinationDirectoryName は長さ 0 の文字列で、空白文字のみを含むか、InvalidPathChars で定義されている無効な文字を 1 つ以上含みます。
destinationDirectoryName は nullです。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。 たとえば、Windows ベースのプラットフォームでは、パスは 248 文字未満にする必要があり、ファイル名は 260 文字未満にする必要があります。
指定されたパスが無効です (たとえば、マップされていないドライブ上にあります)。
アーカイブ エントリの名前は長さ 0 で、空白文字のみを含むか、InvalidPathChars で定義されている無効な文字が 1 つ以上含まれています。
-又は-
アーカイブ エントリを抽出すると、 destinationDirectoryName の外部にある宛先ファイルが生成されます (たとえば、エントリ名に親ディレクトリ アクセサーが含まれている場合)。
-又は-
アーカイブ エントリの名前は、同じアーカイブから既に抽出されたエントリと同じです。
呼び出し元に必要なアクセス許可がありません。
destinationDirectoryName が無効な形式です。
非同期操作は取り消されます。
注釈
指定されたディレクトリは存在できません。 パスには、相対パスまたは絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。
このメソッドは、必要に応じて、すべてのサブディレクトリと指定したディレクトリを作成します。
アーカイブの抽出中にエラーが発生した場合、アーカイブは部分的に抽出されたままです。
各エントリは、抽出されたファイルがアーカイブのルートに destinationDirectoryName する相対パスが同じになるように抽出されます。 アーカイブするファイルに無効な最終変更時刻がある場合は、Zip タイムスタンプ形式で表される最初の日時 (1980 年 1 月 1 日の午前 0 時) が使用されます。
適用対象
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
アーカイブ内のすべてのファイルをファイル システム上のディレクトリに抽出します。 指定したディレクトリが既に存在している可能性があります。
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Taskパラメーター
- source
- ZipArchive
ファイルを抽出する zip アーカイブ。
- destinationDirectoryName
- String
ファイル システム上のディレクトリへのパス。
- overwriteFiles
- Boolean
true ファイルを上書きする場合。それ以外の場合 false 。
- cancellationToken
- CancellationToken
キャンセル要求を監視するキャンセル トークン。
返品
例外
destinationDirectoryName は長さ 0 の文字列で、空白文字のみを含むか、InvalidPathChars で定義されている無効な文字を 1 つ以上含みます。
このメソッドは、必要に応じて、すべてのサブディレクトリと指定したディレクトリを作成します。
アーカイブの抽出中にエラーが発生した場合、アーカイブは部分的に抽出されたままになります。
各エントリは、抽出されたファイルがアーカイブのルートに destinationDirectoryName する相対パスが同じになるように抽出されます。 アーカイブするファイルに無効な最終変更時刻がある場合は、Zip タイムスタンプ形式で表される最初の日時 (1980 年 1 月 1 日の午前 0 時) が使用されます。
destinationDirectoryName は nullです。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。
たとえば、Windows ベースのプラットフォームでは、パスは 248 文字未満にする必要があり、ファイル名は 260 文字未満にする必要があります。
指定されたパスが無効です (たとえば、マップされていないドライブ上にあります)。
アーカイブ エントリの名前は長さ 0 で、空白文字のみを含むか、InvalidPathChars で定義されている無効な文字が 1 つ以上含まれています。
-又は-
アーカイブ エントリを抽出すると、 destinationDirectoryName の外部にある宛先ファイルが生成されます (たとえば、エントリ名に親ディレクトリ アクセサーが含まれている場合)。
-又は-
アーカイブ エントリの名前は、同じアーカイブから既に抽出されたエントリと同じです。
呼び出し元に必要なアクセス許可がありません。
destinationDirectoryName が無効な形式です。
注釈
指定されたディレクトリは存在できません。 パスには、相対パスまたは絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。
適用対象
ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As Taskパラメーター
- source
- ZipArchive
- destinationDirectoryName
- String
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
