TarFile.ExtractToDirectoryAsync Método

Definición

Espacio de nombres:

System.Formats.Tar

Ensamblado:

System.Formats.Tar.dll

Sobrecargas

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)	Extrae de forma asincrónica el contenido de una secuencia que representa un archivo tar en el directorio especificado.
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)	Extrae de forma asincrónica el contenido de un archivo tar en el directorio especificado.

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)

Source:

TarFile.cs

Extrae de forma asincrónica el contenido de una secuencia que representa un archivo tar en el directorio especificado.

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

Parámetros

source

Stream

Secuencia que contiene el archivo tar.

destinationDirectoryName

String

Ruta de acceso del directorio de destino donde se deben extraer las entradas del sistema de archivos.

overwriteFiles

Boolean

true para sobrescribir archivos y directorios en destinationDirectoryName; false para evitar sobrescribir y producir si se encuentran archivos o directorios con nombres existentes.

cancellationToken

CancellationToken

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

Devoluciones

Task

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

Excepciones

ArgumentNullException

source o destinationDirectoryName es null.

DirectoryNotFoundException

No se encuentra la ruta de acceso del destinationDirectoryName directorio.

UnauthorizedAccessException

Los permisos no son suficientes.

ArgumentException

La extracción de una de las entradas tar habría dado lugar a un archivo fuera del directorio de destino especificado.

o bien

destinationDirectoryName está vacía.

o bien

source no es compatible con la lectura.

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

Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.

La elevación es necesaria para extraer un BlockDevice o CharacterDevice en el disco.

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, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por ExtractToDirectory(Stream, String, Boolean).

ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)

Source:

TarFile.cs

Extrae de forma asincrónica el contenido de un archivo tar en el directorio especificado.

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

Parámetros

sourceFileName

String

Ruta de acceso del archivo tar que se va a extraer.

destinationDirectoryName

String

Ruta de acceso del directorio de destino donde se deben extraer las entradas del sistema de archivos.

overwriteFiles

Boolean

true para sobrescribir archivos y directorios en destinationDirectoryName; false para evitar sobrescribir y producir si se encuentran archivos o directorios con nombres existentes.

cancellationToken

CancellationToken

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

Devoluciones

Task

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

Excepciones

ArgumentNullException

sourceFileName o destinationDirectoryName es null.

DirectoryNotFoundException

No se encuentra la ruta de acceso del destinationDirectoryName directorio.

FileNotFoundException

No se encuentra la ruta de acceso del sourceFileName archivo.

UnauthorizedAccessException

Los permisos no son suficientes.

ArgumentException

La extracción de una de las entradas tar habría dado lugar a un archivo fuera del directorio de destino especificado.

O bien

sourceFileName o destinationDirectoryName está vacía.

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

Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.

La elevación es necesaria para extraer un BlockDevice o CharacterDevice en el disco.

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, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por ExtractToDirectory(String, String, Boolean).