TarEntry.ExtractToFileAsync(String, Boolean, 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.
Estrae in modo asincrono la voce corrente nel file system.
public System.Threading.Tasks.Task ExtractToFileAsync(string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);member this.ExtractToFileAsync : string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function ExtractToFileAsync (destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- destinationFileName
- String
Percorso del file di destinazione.
- overwrite
- Boolean
true se questo metodo deve sovrascrivere qualsiasi oggetto file system esistente che si trova nel destinationFileName percorso; false per impedire la sovrascrittura.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento. Il valore predefinito è None.
Valori restituiti
Attività che rappresenta l'operazione di estrazione asincrona.
Eccezioni
destinationFileName è null.
destinationFileName è vuoto.
La directory padre di destinationFileName non esiste.
oppure
overwrite è false e un file esiste già in destinationFileName.
oppure
Esiste una directory con lo stesso nome di destinationFileName.
oppure
Si è verificato un problema di I/O.
Il tipo di voce non è supportato.
Le autorizzazioni non sono sufficienti.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
I file di tipo BlockDevice, CharacterDeviceo Fifo possono essere estratti solo nelle piattaforme Unix.
L'elevazione dei privilegi è necessaria per estrarre un BlockDevice oggetto o CharacterDevice su disco.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da ExtractToFile(String, Boolean).
