ZipFile.OpenReadAsync(String, CancellationToken) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.