ZipFileExtensions.ExtractToDirectoryAsync メソッド

ソース:

ZipFileExtensions.ZipArchive.Extract.Async.cs

ソース:

ZipFileExtensions.ZipArchive.Extract.Async.cs

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

パラメーター

返品

例外

注釈

destinationDirectoryNameで指定されたディレクトリは既に存在できます。 このメソッドは、エントリを抽出するときに必要に応じて、宛先ディレクトリ、その不足している親ディレクトリ、およびサブディレクトリを作成します。 アーカイブが空の場合、このメソッドは宛先ディレクトリを作成しません。

パスには、相対パスまたは絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。

アーカイブの抽出中にエラーが発生した場合、アーカイブは部分的に抽出されたままです。

各エントリは、抽出されたファイルがアーカイブのルートに destinationDirectoryName する相対パスが同じになるように抽出されます。 アーカイブするファイルに無効な最終変更時刻がある場合は、Zip タイムスタンプ形式で表される最初の日時 (1980 年 1 月 1 日の午前 0 時) が使用されます。

ソース:

ZipFileExtensions.ZipArchive.Create.cs

ソース:

ZipFileExtensions.ZipArchive.Extract.Async.cs

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

パラメーター

返品

例外

注釈

destinationDirectoryNameで指定されたディレクトリは既に存在できます。 このメソッドは、エントリを抽出するときに必要に応じて、宛先ディレクトリ、その不足している親ディレクトリ、およびサブディレクトリを作成します。 アーカイブが空の場合、このメソッドは宛先ディレクトリを作成しません。

パスには、相対パスまたは絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。

ソース:

ZipFileExtensions.ZipArchive.Extract.Async.cs

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

パラメーター

返品

注釈

destinationDirectoryNameで指定されたディレクトリは既に存在できます。 このメソッドは、エントリを抽出するときに必要に応じて、宛先ディレクトリ、その不足している親ディレクトリ、およびサブディレクトリを作成します。 アーカイブが空の場合、このメソッドは宛先ディレクトリを作成しません。

抽出された各ファイルは、ソース エントリがアーカイブのルートに対して持っているのと同じ相対パスを destinationDirectoryName します。

destinationDirectoryName パラメーターは、相対パスと絶対パスを受け入れます。 相対パスは、現在の作業ディレクトリに対する相対パスとして解釈されます。

抽出中にエラーが発生した場合、アーカイブは部分的に抽出されたままになります。

OverwriteFilesをtrueに設定して、既存のファイルを上書きします。 既定値は false であり、抽出するファイルが既に存在する場合、抽出によって IOException がスローされます。

Passwordを使用して、暗号化されたエントリのパスワードを指定します。

EntryNameEncoding は、このオーバーロードでは使用されません。 エントリ名とコメントは、 source アーカイブを開いたときに指定されたエンコードを使用してデコードされます。

アーカイブ内のシンボリック リンクは、シンボリック リンクとして再作成されません。 destinationDirectoryNameまたはその親ディレクトリのいずれかが既存のジャンクションまたはシンボリック リンクである場合、リンクがフォローされ、最終的なターゲット フォルダーへの書き込みが抽出されます。

非同期抽出中に発生する例外は、返されたタスクに格納され、タスクが待機しているときにスローされます。