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.Task
Public Function ExtractToFileAsync (destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task
Parametri
- 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 evitare la sovrascrittura.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento. Il valore predefinito è None.
Restituisce
Attività che rappresenta l'operazione di estrazione asincrona.
Eccezioni
destinationFileName
è null
.
destinationFileName
è vuoto.
La directory padre di destinationFileName
non esiste.
-oppure-
overwrite
è false
e esiste già un file in destinationFileName
.
-oppure-
Una directory esiste 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 è necessaria per estrarre un BlockDevice disco 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).