ZipFileExtensions.CreateEntryFromFileAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken) |
指定したエントリ名の下のアーカイブに、ファイル システムからファイルを非同期に追加します。 |
| CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken) |
指定したエントリ名の下のアーカイブに、ファイル システムからファイルを非同期に追加します。 |
CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken)
指定したエントリ名の下のアーカイブに、ファイル システムからファイルを非同期に追加します。
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)パラメーター
- destination
- ZipArchive
ファイルを追加する zip アーカイブ。
- sourceFileName
- String
コピーするファイル システム上のファイルへのパス。 パスには、相対パスまたは絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。
- entryName
- String
作成するエントリの名前。
- cancellationToken
- CancellationToken
キャンセル要求を監視するキャンセル トークン。
返品
新しく作成されたエントリのラッパー。
例外
sourceFileName は長さ 0 の文字列で、空白文字のみを含むか、InvalidPathChars で定義されている無効な文字を 1 つ以上含みます。
-又は-
entryName は長さ 0 の文字列です。
sourceFileName または entryName が null。
sourceFileNameでは、指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。 たとえば、Windows ベースのプラットフォームでは、パスは 248 文字未満にする必要があり、ファイル名は 260 文字未満にする必要があります。
指定した sourceFileName が無効です (たとえば、マップされていないドライブ上にあります)。
sourceFileNameで指定されたファイルを開くときに I/O エラーが発生しました。
sourceFileNameで指定されたファイルが見つかりませんでした。
sourceFileName が無効な形式であるか、ZipArchive が書き込みをサポートしていません。
ZipArchive は既に閉じられています。
非同期操作は取り消されます。
注釈
アーカイブ内の新しいエントリには、ファイルの内容が含まれます。
アーカイブ項目の最終書き込み時刻は、ファイル・システム上のファイルの最終書き込み時刻に設定されます。
指定した名前のエントリがアーカイブに既に存在する場合は、同じ名前の 2 番目のエントリが作成されます。
指定されたソース ファイルに無効な最終変更時刻がある場合は、Zip タイムスタンプ形式で表される最初の日時 (1980 年 1 月 1 日午前 0 時) が使用されます。 指定した名前のエントリがアーカイブに既に存在する場合は、同じ名前の 2 番目のエントリが作成されます。
CompressionLevelが指定されていないため、基になる圧縮アルゴリズムの実装によって提供される既定値が使用されます。ZipArchiveは独自の既定値を適用しません。
(現在、基になる圧縮アルゴリズムは、 DeflateStream クラスによって提供されています)。
適用対象
CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken)
指定したエントリ名の下のアーカイブに、ファイル システムからファイルを非同期に追加します。
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.IO.Compression.CompressionLevel * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, compressionLevel As CompressionLevel, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)パラメーター
- destination
- ZipArchive
ファイルを追加する zip アーカイブ。
- sourceFileName
- String
コピーするファイル システム上のファイルへのパス。 パスには、相対パスまたは絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。
- entryName
- String
作成するエントリの名前。
- compressionLevel
- CompressionLevel
圧縮のレベル (速度/メモリと圧縮サイズのトレードオフ)。
- cancellationToken
- CancellationToken
キャンセル要求を監視するキャンセル トークン。
返品
新しく作成されたエントリのラッパー。
例外
sourceFileName は長さ 0 の文字列で、空白文字のみを含むか、InvalidPathChars で定義されている無効な文字を 1 つ以上含みます。
-又は-
entryName は長さ 0 の文字列です。
sourceFileName または entryName が null。
sourceFileNameでは、指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。 たとえば、Windows ベースのプラットフォームでは、パスは 248 文字未満にする必要があり、ファイル名は 260 文字未満にする必要があります。
指定した sourceFileName が無効です (たとえば、マップされていないドライブ上にあります)。
sourceFileNameで指定されたファイルを開くときに I/O エラーが発生しました。
sourceFileNameで指定されたファイルが見つかりませんでした。
sourceFileName が無効な形式であるか、ZipArchive が書き込みをサポートしていません。
ZipArchive は既に閉じられています。
非同期操作は取り消されます。
注釈
アーカイブ内の新しいエントリには、ファイルの内容が含まれます。
アーカイブ項目の最終書き込み時刻は、ファイル・システム上のファイルの最終書き込み時刻に設定されます。
指定した名前のエントリがアーカイブに既に存在する場合は、同じ名前の 2 番目のエントリが作成されます。
指定されたソース ファイルに無効な最終変更時刻がある場合は、Zip タイムスタンプ形式で表される最初の日時 (1980 年 1 月 1 日午前 0 時) が使用されます。 指定した名前のエントリがアーカイブに既に存在する場合は、同じ名前の 2 番目のエントリが作成されます。
