ZipFile.OpenReadAsync(String, CancellationToken) Metode

Definisi

Ruang nama:

System.IO.Compression

Rakitan:

netstandard.dll, System.IO.Compression.ZipFile.dll

Sumber:

ZipFile.Create.Async.cs

Secara asinkron membuka ZipArchive pada jalur yang ditentukan untuk membaca. File yang ditentukan dibuka dengan 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)

Parameter

archiveFileName

String

String yang menentukan jalur pada sistem file untuk membuka arsip. Jalur diizinkan untuk menentukan informasi jalur relatif atau absolut. Informasi jalur relatif ditafsirkan relatif terhadap direktori kerja saat ini.

cancellationToken

CancellationToken

Token pembatalan untuk memantau permintaan pembatalan.

Mengembalikan

Task<ZipArchive>

Pengecualian

ArgumentException

archiveFileName adalah string panjang nol, hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid seperti yang didefinisikan oleh InvalidPathChars.

ArgumentNullException

archiveFileName adalah null.

PathTooLongException

ArchiveFileName yang ditentukan melebihi panjang maksimum yang ditentukan sistem.

Misalnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.

DirectoryNotFoundException

ArchiveFileName yang ditentukan tidak valid, (misalnya, ada di drive yang tidak dipetakan).

IOException

Terjadi kesalahan I/O yang tidak ditentukan saat membuka file.

UnauthorizedAccessException

archiveFileName menentukan direktori.

-atau-

Pemanggil tidak memiliki izin yang diperlukan.

FileNotFoundException

File yang ditentukan dalam archiveFileName tidak ditemukan.

NotSupportedException

archiveFileName dalam format yang tidak valid.

InvalidDataException

File yang ditentukan tidak dapat ditafsirkan sebagai file zip.

OperationCanceledException

Operasi asinkron dibatalkan.