TarFile.CreateFromDirectoryAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
.
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).