TarFile.ExtractToDirectoryAsync Metodo

Definizione

Spazio dei nomi:

System.Formats.Tar

Assembly:

System.Formats.Tar.dll

Overload

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)	Estrae in modo asincrono il contenuto di un flusso che rappresenta un archivio tar nella directory specificata.
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)	Estrae in modo asincrono il contenuto di un file tar nella directory specificata.

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)

Origine:

TarFile.cs

Estrae in modo asincrono il contenuto di un flusso che rappresenta un archivio tar nella directory specificata.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync (System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : System.IO.Stream * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

source

Stream

Flusso contenente l'archivio tar.

destinationDirectoryName

String

Percorso della directory di destinazione in cui devono essere estratte le voci del file system.

overwriteFiles

Boolean

true per sovrascrivere file e directory in destinationDirectoryName; false per evitare la sovrascrittura e generare se vengono trovati file o directory con nomi esistenti.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task

Attività che rappresenta l'operazione di estrazione asincrona.

Eccezioni

ArgumentNullException

source o destinationDirectoryName è null.

DirectoryNotFoundException

Il percorso della destinationDirectoryName directory non viene trovato.

UnauthorizedAccessException

Le autorizzazioni non sono sufficienti.

ArgumentException

L'estrazione di una delle voci tar avrebbe generato un file all'esterno della directory di destinazione specificata.

-oppure-

destinationDirectoryName è vuoto.

-oppure-

source non supporta la lettura.

IOException

Si è verificata un'eccezione di I/O.

OperationCanceledException

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à 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 ExtractToDirectory(Stream, String, Boolean).

ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)

Origine:

TarFile.cs

Estrae in modo asincrono il contenuto di un file tar nella directory specificata.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync (string sourceFileName, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

sourceFileName

String

Percorso del file tar da estrarre.

destinationDirectoryName

String

Percorso della directory di destinazione in cui devono essere estratte le voci del file system.

overwriteFiles

Boolean

true per sovrascrivere file e directory in destinationDirectoryName; false per evitare la sovrascrittura e generare se vengono trovati file o directory con nomi esistenti.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task

Attività che rappresenta l'operazione di estrazione asincrona.

Eccezioni

ArgumentNullException

sourceFileName o destinationDirectoryName è null.

DirectoryNotFoundException

Il percorso della destinationDirectoryName directory non viene trovato.

FileNotFoundException

Il percorso del sourceFileName file non viene trovato.

UnauthorizedAccessException

Le autorizzazioni non sono sufficienti.

ArgumentException

L'estrazione di una delle voci tar avrebbe generato un file all'esterno della directory di destinazione specificata.

-oppure-

sourceFileName o destinationDirectoryName è vuoto.

IOException

Si è verificata un'eccezione di I/O.

OperationCanceledException

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à 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 ExtractToDirectory(String, String, Boolean).