TarFile.CreateFromDirectoryAsync Método

Definición

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
Source:
TarFile.cs
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

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

Excepciones

sourceDirectoryName o destination es null.

sourceDirectoryName está vacía.

o bien

destination no admite la escritura.

No se encuentra la ruta de acceso del sourceDirectoryName directorio.

Se produjo una excepción de E/S.

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).

Se aplica a

CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)

Source:
TarFile.cs
Source:
TarFile.cs
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

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

Excepciones

sourceDirectoryName o destinationFileName es null.

sourceDirectoryName o destinationFileName está vacía.

No se encuentra la ruta de acceso del sourceDirectoryName directorio.

Se produjo una excepción de E/S.

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).

Se aplica a