TarFile.CreateFromDirectoryAsync Metodo

Definizione

Spazio dei nomi:

System.Formats.Tar

Assembly:

System.Formats.Tar.dll

Overload

CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)	Crea in modo asincrono un flusso tar che contiene tutte le voci del file system dalla directory specificata.
CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)	Crea in modo asincrono un archivio tar dal contenuto della directory specificata e li restituisce nel percorso specificato. Può facoltativamente includere la directory di base come prefisso per i nomi delle voci.

CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)

Origine:

TarFile.cs

Crea in modo asincrono un flusso tar che contiene tutte le voci del file system dalla directory specificata.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync (string sourceDirectoryName, System.IO.Stream destination, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

sourceDirectoryName

String

Percorso della directory da archiviare.

destination

Stream

Flusso di destinazione dell'archivio.

includeBaseDirectory

Boolean

true per includere il nome della directory di base come primo segmento di percorso in tutti i nomi delle voci di archivio. false per escludere il nome della directory di base dai percorsi del nome della voce.

cancellationToken

CancellationToken

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

Restituisce

Task

Attività che rappresenta l'operazione di creazione asincrona.

Eccezioni

ArgumentNullException

sourceDirectoryName o destination è null.

ArgumentException

sourceDirectoryName è vuoto.

-oppure-

destination non supporta la scrittura.

DirectoryNotFoundException

Il percorso della sourceDirectoryName directory non viene trovato.

IOException

Si è verificata un'eccezione di I/O.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

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

CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)

Origine:

TarFile.cs

Crea in modo asincrono un archivio tar dal contenuto della directory specificata e li restituisce nel percorso specificato. Può facoltativamente includere la directory di base come prefisso per i nomi delle voci.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync (string sourceDirectoryName, string destinationFileName, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationFileName As String, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

sourceDirectoryName

String

Percorso della directory da archiviare.

destinationFileName

String

Percorso del file di archivio di destinazione.

includeBaseDirectory

Boolean

true per includere il nome della directory di base come primo segmento di percorso in tutti i nomi delle voci di archivio. false per escludere il nome della directory di base dai percorsi del nome della voce.

cancellationToken

CancellationToken

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

Restituisce

Task

Attività che rappresenta l'operazione di creazione asincrona.

Eccezioni

ArgumentNullException

sourceDirectoryName o destinationFileName è null.

ArgumentException

sourceDirectoryName o destinationFileName è vuoto.

DirectoryNotFoundException

Il percorso della sourceDirectoryName directory non viene trovato.

IOException

Si è verificata un'eccezione di I/O.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

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