TarFile.CreateFromDirectoryAsync Método

Definición

Espacio de nombres:

System.Formats.Tar

Ensamblado:

System.Formats.Tar.dll

Sobrecargas

CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)	Crea de forma asincrónica una secuencia tar que contiene todas las entradas del sistema de archivos del directorio especificado.
CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)	Crea de forma asincrónica un archivo tar a partir del contenido del directorio especificado y los genera en la ruta de acceso especificada. Opcionalmente, puede incluir el directorio base como prefijo para los nombres de entrada.

CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)

Source:

TarFile.cs

Crea de forma asincrónica una secuencia tar que contiene todas las entradas del sistema de archivos del directorio especificado.

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

Parámetros

sourceDirectoryName

String

Ruta de acceso del directorio que se va a archivar.

destination

Stream

Secuencia de destino del archivo.

includeBaseDirectory

Boolean

true para incluir el nombre del directorio base como primer segmento de ruta de acceso en todos los nombres de las entradas de archivo. false para excluir el nombre del directorio base de las rutas de acceso de nombre de entrada.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Task

Tarea que representa la operación de creación asincrónica.

Excepciones

ArgumentNullException

sourceDirectoryName o destination es null.

ArgumentException

sourceDirectoryName está vacía.

o bien

destination no admite la escritura.

DirectoryNotFoundException

No se encuentra la ruta de acceso del sourceDirectoryName directorio.

IOException

Se produjo una excepción de E/S.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por CreateFromDirectory(String, Stream, Boolean).

CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)

Source:

TarFile.cs

Crea de forma asincrónica un archivo tar a partir del contenido del directorio especificado y los genera en la ruta de acceso especificada. Opcionalmente, puede incluir el directorio base como prefijo para los nombres de entrada.

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

Parámetros

sourceDirectoryName

String

Ruta de acceso del directorio que se va a archivar.

destinationFileName

String

Ruta de acceso del archivo de archivo de destino.

includeBaseDirectory

Boolean

true para incluir el nombre del directorio base como primer segmento de ruta de acceso en todos los nombres de las entradas de archivo. false para excluir el nombre del directorio base de las rutas de acceso de nombre de entrada.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Task

Tarea que representa la operación de creación asincrónica.

Excepciones

ArgumentNullException

sourceDirectoryName o destinationFileName es null.

ArgumentException

sourceDirectoryName o destinationFileName está vacía.

DirectoryNotFoundException

No se encuentra la ruta de acceso del sourceDirectoryName directorio.

IOException

Se produjo una excepción de E/S.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por CreateFromDirectory(String, String, Boolean).