ZipFile.OpenReadAsync(String, CancellationToken) メソッド

定義

指定したパスの ZipArchive を読み取り用に非同期的に開きます。 指定したファイルが FileMode.Openで開かれます。

public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchive> OpenReadAsync(string archiveFileName, System.Threading.CancellationToken cancellationToken = default);
static member OpenReadAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchive>
Public Shared Function OpenReadAsync (archiveFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchive)

パラメーター

archiveFileName
String

アーカイブを開くファイル システム上のパスを指定する文字列。 パスには、相対パスまたは絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。

cancellationToken
CancellationToken

キャンセル要求を監視するキャンセル トークン。

返品

例外

archiveFileName は長さ 0 の文字列で、空白文字のみを含むか、InvalidPathChars で定義されている無効な文字を 1 つ以上含みます。

archiveFileName が null

指定した archiveFileName が、システム定義の最大長を超えています。

たとえば、Windows ベースのプラットフォームでは、パスは 248 文字未満にする必要があり、ファイル名は 260 文字未満にする必要があります。

指定した archiveFileName が無効です (たとえば、マップされていないドライブ上にあります)。

ファイルを開くときに、指定されていない I/O エラーが発生しました。

archiveFileName はディレクトリを指定しました。

-又は-

呼び出し元に必要なアクセス許可がありません。

archiveFileName で指定されたファイルが見つかりませんでした。

archiveFileName の形式が無効です。

指定されたファイルを zip ファイルとして解釈できませんでした。

非同期操作は取り消されます。

適用対象