ZipFileExtensions.ExtractToFileAsync 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.
Overload
| Nome | Descrizione |
|---|---|
| ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken) |
Crea in modo asincrono un file nel file system con il contenuto della voce e il nome specificato. |
| ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken) |
Crea in modo asincrono un file nel file system con il contenuto della voce e il nome specificato. |
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)
Crea in modo asincrono un file nel file system con il contenuto della voce e il nome specificato.
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- source
- ZipArchiveEntry
Voce di archivio ZIP da cui estrarre un file.
- destinationFileName
- String
Nome del file che conterrà il contenuto della voce.
- cancellationToken
- CancellationToken
Token di annullamento da monitorare per le richieste di annullamento.
Valori restituiti
Eccezioni
Il chiamante non dispone dell'autorizzazione richiesta.
destinationFileName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi, come definito da InvalidPathChars.
oppure
destinationFileName specifica una directory.
destinationFileName è null.
Il percorso, il nome file specificato o entrambi superano 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.
Il percorso specificato in destinationFileName non è valido( ad esempio, si trova in un'unità non mappata).
Si è verificato un errore di I/O.
oppure
La voce è attualmente aperta per la scrittura.
oppure
La voce è stata eliminata dall'archivio.
destinationFileName è in un formato non valido.
oppure
ZipArchive a cui appartiene questa voce è stato aperto in modalità di sola scrittura.
La voce non è presente nell'archivio o è danneggiata e non può essere letta.
oppure
La voce è stata compressa usando un metodo di compressione non supportato.
ZipArchive a cui appartiene questa voce è stata eliminata.
Commenti
Il percorso specificato è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente.
L'ora dell'ultima scrittura del file viene impostata sull'ora dell'ultima scrittura della voce. Questo metodo non consente la sovrascrittura di un file esistente con lo stesso nome. Il tentativo di estrarre directory esplicite (voci con nomi che terminano con caratteri separatori di directory) non comporterà la creazione di una directory.
Si applica a
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)
Crea in modo asincrono un file nel file system con il contenuto della voce e il nome specificato.
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- source
- ZipArchiveEntry
Voce di archivio ZIP da cui estrarre un file.
- destinationFileName
- String
Nome del file che conterrà il contenuto della voce.
- overwrite
- Boolean
true per sovrascrivere i file; false Altrimenti.
- cancellationToken
- CancellationToken
Token di annullamento da monitorare per le richieste di annullamento.
Valori restituiti
Eccezioni
Il chiamante non dispone dell'autorizzazione richiesta.
destinationFileName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi, come definito da InvalidPathChars.
oppure
destinationFileName specifica una directory.
destinationFileName è null.
Il percorso, il nome file specificato o entrambi superano 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.
Il percorso specificato in destinationFileName non è valido( ad esempio, si trova in un'unità non mappata).
Si è verificato un errore di I/O.
oppure
La voce è attualmente aperta per la scrittura.
oppure
La voce è stata eliminata dall'archivio.
destinationFileName è in un formato non valido.
oppure
ZipArchive a cui appartiene questa voce è stato aperto in modalità di sola scrittura.
La voce non è presente nell'archivio o è danneggiata e non può essere letta.
oppure
La voce è stata compressa usando un metodo di compressione non supportato.
ZipArchive a cui appartiene questa voce è stata eliminata.
Un'operazione asincrona viene annullata.
Commenti
Il percorso specificato è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente.
L'ora dell'ultima scrittura del file viene impostata sull'ora dell'ultima scrittura della voce.
Questo metodo consente la sovrascrittura di un file esistente con lo stesso nome.
