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
| Nombre | Description |
|---|---|
| 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) |
Extrae de forma asincrónica el contenido de una secuencia que representa un archivo tar en el directorio especificado. |
| ExtractToDirectoryAsync(Stream, String, TarExtractOptions, CancellationToken) | |
| ExtractToDirectoryAsync(String, String, TarExtractOptions, CancellationToken) |
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- 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. En .NET 11 y versiones anteriores, el directorio ya debe existir. En .NET 12 y versiones posteriores, los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
- 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 que se va a supervisar para las solicitudes de cancelación. El valor por defecto es None.
Devoluciones
Tarea que representa la operación de extracción asincrónica.
Excepciones
sourceFileName o destinationDirectoryName es null.
.NET 11 y versiones anteriores: el destinationDirectoryName directorio no existe.
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ío.
Solo .NET 11 y versiones posteriores: la suma de comprobación de una entrada no es válida.
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
Warning
Este método no se debe usar para extraer archivos que no son de confianza. No aplica ningún límite de tamaño, límites de recuento de entradas u otras directivas necesarias para la extracción segura de archivos que no son de confianza. Para obtener más información sobre cómo extraer archivos de forma segura de orígenes que no son de confianza, consulte Procedimientos recomendados para usar archivos zip y tar.
En .NET 11 y versiones anteriores, el directorio especificado por destinationDirectoryName ya debe existir. Si no existe, este método produce un DirectoryNotFoundException, incluso si el archivo está vacío.
En .NET 12 y versiones posteriores, el directorio de destino ya puede existir. Los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
Si un vínculo simbólico o una unión en el archivo tar da como resultado que un archivo se extraiga fuera del especificado destinationDirectoryName, se produce una IOException excepción para asegurarse de que la extracción permanece dentro del mismo directorio.
Si destinationDirectoryName o cualquiera de sus directorios primarios es una unión preexistente o un vínculo simbólico, se sigue el vínculo y la extracción escribe en la carpeta de destino final.
Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.
La elevación es necesaria para extraer un BlockDevice disco o CharacterDevice .
Este método almacena en la tarea que devuelve todas las excepciones de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por ExtractToDirectory(String, String, Boolean).
Se aplica a
ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- 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. En .NET 11 y versiones anteriores, el directorio ya debe existir. En .NET 12 y versiones posteriores, los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
- 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 que se va a supervisar para las solicitudes de cancelación. El valor por defecto es None.
Devoluciones
Tarea que representa la operación de extracción asincrónica.
Excepciones
source o destinationDirectoryName es null.
.NET 11 y versiones anteriores: el destinationDirectoryName directorio no existe.
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ío.
– O bien –
source no admite la lectura.
Solo .NET 11 y versiones posteriores: la suma de comprobación de una entrada no es válida.
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
Warning
Este método no se debe usar para extraer archivos que no son de confianza. No aplica ningún límite de tamaño, límites de recuento de entradas u otras directivas necesarias para la extracción segura de archivos que no son de confianza. Para obtener más información sobre cómo extraer archivos de forma segura de orígenes que no son de confianza, consulte Procedimientos recomendados para usar archivos zip y tar.
En .NET 11 y versiones anteriores, el directorio especificado por destinationDirectoryName ya debe existir. Si no existe, este método produce un DirectoryNotFoundException, incluso si el archivo está vacío.
En .NET 12 y versiones posteriores, el directorio de destino ya puede existir. Los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
Si un vínculo simbólico o una unión en el archivo tar da como resultado que un archivo se extraiga fuera del especificado destinationDirectoryName, se produce una IOException excepción para asegurarse de que la extracción permanece dentro del mismo directorio.
Si destinationDirectoryName o cualquiera de sus directorios primarios es una unión preexistente o un vínculo simbólico, se sigue el vínculo y la extracción escribe en la carpeta de destino final.
Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.
La elevación es necesaria para extraer un BlockDevice disco o CharacterDevice .
Este método almacena en la tarea que devuelve todas las excepciones de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por ExtractToDirectory(Stream, String, Boolean).
Se aplica a
ExtractToDirectoryAsync(Stream, String, TarExtractOptions, CancellationToken)
- Source:
- TarFile.cs
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Formats.Tar.TarExtractOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, options As TarExtractOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- source
- Stream
- destinationDirectoryName
- String
Ruta de acceso al directorio en el que se van a colocar los archivos extraídos. En .NET 11 y versiones anteriores, el directorio ya debe existir. En .NET 12 y versiones posteriores, los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
- options
- TarExtractOptions
- cancellationToken
- CancellationToken
Devoluciones
Excepciones
.NET 11 y versiones anteriores: el destinationDirectoryName directorio no existe.
Comentarios
Warning
Este método no se debe usar para extraer archivos que no son de confianza. No aplica ningún límite de tamaño, límites de recuento de entradas u otras directivas necesarias para la extracción segura de archivos que no son de confianza. Para obtener más información sobre cómo extraer archivos de forma segura de orígenes que no son de confianza, consulte Procedimientos recomendados para usar archivos zip y tar.
En .NET 11 y versiones anteriores, el directorio especificado por destinationDirectoryName ya debe existir. Si no existe, este método produce un DirectoryNotFoundException, incluso si el archivo está vacío.
En .NET 12 y versiones posteriores, el directorio de destino ya puede existir. Los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
La ruta de acceso puede ser relativa o absoluta. Una ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual.
Si se produce un error durante la extracción, el archivo permanece parcialmente extraído.
Establézcalo OverwriteFiles en true para sobrescribir los archivos existentes. El valor predeterminado es false. Use HardLinkMode para controlar cómo se extraen las entradas de vínculo físico.
Si un vínculo simbólico o una unión en el archivo tar da como resultado que un archivo se extraiga fuera del especificado destinationDirectoryName, se produce una IOException excepción para asegurarse de que la extracción permanece dentro del mismo directorio.
Si destinationDirectoryName o cualquiera de sus directorios primarios es una unión preexistente o un vínculo simbólico, se sigue el vínculo y la extracción escribe en la carpeta de destino final.
Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.
La elevación es necesaria para extraer un BlockDevice disco o CharacterDevice .
La source secuencia se deja abierta después de la extracción.
Las excepciones que se producen durante la extracción asincrónica se almacenan en la tarea devuelta y se producen cuando se espera la tarea.
Se aplica a
ExtractToDirectoryAsync(String, String, TarExtractOptions, CancellationToken)
- Source:
- TarFile.cs
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceFileName, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.Formats.Tar.TarExtractOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- sourceFileName
- String
- destinationDirectoryName
- String
Ruta de acceso al directorio en el que se van a colocar los archivos extraídos. En .NET 11 y versiones anteriores, el directorio ya debe existir. En .NET 12 y versiones posteriores, los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
- options
- TarExtractOptions
- cancellationToken
- CancellationToken
Devoluciones
Excepciones
.NET 11 y versiones anteriores: el destinationDirectoryName directorio no existe.
Comentarios
Warning
Este método no se debe usar para extraer archivos que no son de confianza. No aplica ningún límite de tamaño, límites de recuento de entradas u otras directivas necesarias para la extracción segura de archivos que no son de confianza. Para obtener más información sobre cómo extraer archivos de forma segura de orígenes que no son de confianza, consulte Procedimientos recomendados para usar archivos zip y tar.
En .NET 11 y versiones anteriores, el directorio especificado por destinationDirectoryName ya debe existir. Si no existe, este método produce un DirectoryNotFoundException, incluso si el archivo está vacío.
En .NET 12 y versiones posteriores, el directorio de destino ya puede existir. Los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
La ruta de acceso puede ser relativa o absoluta. Una ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual.
Si se produce un error durante la extracción, el archivo permanece parcialmente extraído.
Establézcalo OverwriteFiles en true para sobrescribir los archivos existentes. El valor predeterminado es false. Use HardLinkMode para controlar cómo se extraen las entradas de vínculo físico.
Si un vínculo simbólico o una unión en el archivo tar da como resultado que un archivo se extraiga fuera del especificado destinationDirectoryName, se produce una IOException excepción para asegurarse de que la extracción permanece dentro del mismo directorio.
Si destinationDirectoryName o cualquiera de sus directorios primarios es una unión preexistente o un vínculo simbólico, se sigue el vínculo y la extracción escribe en la carpeta de destino final.
Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.
La elevación es necesaria para extraer un BlockDevice disco o CharacterDevice .
Las excepciones que se producen durante la extracción asincrónica se almacenan en la tarea devuelta y se producen cuando se espera la tarea.
