TarFile.ExtractToDirectoryAsync 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
| 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
- Source:
- TarFile.cs
- 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.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskPará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
Tarea que representa la operación de extracción asincrónica.
Excepciones
source o destinationDirectoryName es null.
No se encuentra la ruta de acceso del destinationDirectoryName directorio.
Los permisos no son suficientes.
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.
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
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).
Se aplica a
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- 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.TaskPublic Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskPará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
Tarea que representa la operación de extracción asincrónica.
Excepciones
sourceFileName o destinationDirectoryName es null.
No se encuentra la ruta de acceso del destinationDirectoryName directorio.
No se encuentra la ruta de acceso del sourceFileName archivo.
Los permisos no son suficientes.
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.
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
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).
