ZipFile.OpenReadAsync(String, CancellationToken) Metodo

Definizione

Apre in modo asincrono un oggetto ZipArchive nel percorso specificato per la lettura. Il file specificato viene aperto con 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)

Parametri

archiveFileName
String

Stringa che specifica il percorso nel file system in cui aprire l'archivio. Il percorso è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente.

cancellationToken
CancellationToken

Token di annullamento da monitorare per le richieste di annullamento.

Valori restituiti

Eccezioni

archiveFileName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi, come definito da InvalidPathChars.

archiveFileName è null.

L'oggetto archiveFileName specificato supera la lunghezza massima definita dal sistema.

Ad esempio, nelle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi di file devono essere inferiori a 260 caratteri.

L'elemento archiveFileName specificato non è valido, ad esempio in un'unità non mappata.

Errore di I/O non specificato durante l'apertura del file.

archiveFileName è stata specificata una directory.

oppure

Il chiamante non dispone dell'autorizzazione richiesta.

Impossibile trovare il file specificato in archiveFileName.

archiveFileName è in un formato non valido.

Impossibile interpretare il file specificato come file ZIP.

Un'operazione asincrona viene annullata.

Si applica a