ZipFileExtensions.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í.
Extrae todos los archivos del archivo en un directorio del sistema de archivos. Es posible que el directorio especificado ya exista.
Sobrecargas
| Nombre | Description |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
Extrae de forma asincrónica todos los archivos del archivo en un directorio del sistema de archivos. El directorio especificado ya puede existir. |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
Extrae todos los archivos del archivo en un directorio del sistema de archivos. El directorio especificado ya puede existir. |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
Extrae de forma asincrónica todos los archivos del archivo en un directorio del sistema de archivos. El directorio especificado ya puede existir.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- source
- ZipArchive
Archivo ZIP del que se extraerán los archivos.
- destinationDirectoryName
- String
Ruta de acceso al directorio del sistema de archivos. El directorio ya puede existir. Los directorios que faltan se crean según sea necesario al extraer entradas.
- cancellationToken
- CancellationToken
Token de cancelación que se va a supervisar para las solicitudes de cancelación.
Devoluciones
Excepciones
destinationDirectoryName es una cadena de longitud cero, contiene solo espacios en blanco o contiene uno o varios caracteres no válidos, tal como se define en InvalidPathChars.
destinationDirectoryName es null.
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas de acceso deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.
La ruta de acceso especificada no es válida (por ejemplo, se encuentra en una unidad no asignada).
El nombre de una entrada de archivo es de longitud cero, contiene solo espacios en blanco o contiene uno o varios caracteres no válidos, tal como se define en InvalidPathChars.
-o bien-
La extracción de una entrada de archivo habría dado lugar a un archivo de destino que está fuera destinationDirectoryName (por ejemplo, si el nombre de entrada contiene descriptores de acceso de directorio primarios).
-o bien-
Una entrada de archivo tiene el mismo nombre que una entrada ya extraída del mismo archivo.
El autor de la llamada no tiene el permiso necesario.
destinationDirectoryName tiene un formato no válido.
No se encontró una entrada de archivo o está dañada.
-o bien-
Se ha comprimido una entrada de archivo mediante un método de compresión que no se admite.
Se cancela una operación asincrónica.
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.
El directorio especificado por destinationDirectoryName ya puede existir. Este método crea el directorio de destino, sus directorios primarios que faltan y subdirectorios según sea necesario al extraer entradas. Si el archivo está vacío, este método no crea el directorio de destino.
La ruta de acceso puede especificar información de ruta de acceso relativa o absoluta. La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual.
Si se produce un error al extraer el archivo, el archivo permanece parcialmente extraído.
Cada entrada se extrae de forma que el archivo extraído tenga la misma ruta de acceso relativa a destinationDirectoryName la que la entrada tiene en la raíz del archivo. Si un archivo que se va a archivar tiene una hora de última modificación no válida, se usará la primera fecha y hora que se pueda representar en el formato de marca de tiempo Zip (medianoche del 1 de enero de 1980).
Se aplica a
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
Extrae todos los archivos del archivo en un directorio del sistema de archivos. El directorio especificado ya puede existir.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- source
- ZipArchive
Archivo ZIP del que se extraerán los archivos.
- destinationDirectoryName
- String
Ruta de acceso al directorio del sistema de archivos. El directorio ya puede existir. Los directorios que faltan se crean según sea necesario al extraer entradas.
- overwriteFiles
- Boolean
true para sobrescribir archivos; false de lo contrario.
- cancellationToken
- CancellationToken
Token de cancelación que se va a supervisar para las solicitudes de cancelación.
Devoluciones
Excepciones
destinationDirectoryName es una cadena de longitud cero, contiene solo espacios en blanco o contiene uno o varios caracteres no válidos, tal como se define en InvalidPathChars.
Este método crea directorios que faltan según sea necesario al extraer entradas.
Si se produce un error al extraer el archivo, el archivo permanecerá parcialmente extraído.
Cada entrada se extrae de forma que el archivo extraído tenga la misma ruta de acceso relativa a destinationDirectoryName la que la entrada tiene en la raíz del archivo. Si un archivo que se va a archivar tiene una hora de última modificación no válida, se usará la primera fecha y hora que se pueda representar en el formato de marca de tiempo Zip (medianoche del 1 de enero de 1980).
destinationDirectoryName es null.
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
Por ejemplo, en plataformas basadas en Windows, las rutas de acceso deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.
La ruta de acceso especificada no es válida (por ejemplo, se encuentra en una unidad no asignada).
El nombre de una entrada de archivo es de longitud cero, contiene solo espacios en blanco o contiene uno o varios caracteres no válidos, tal como se define en InvalidPathChars.
-o bien-
La extracción de una entrada de archivo habría dado lugar a un archivo de destino que está fuera destinationDirectoryName (por ejemplo, si el nombre de entrada contiene descriptores de acceso de directorio primarios).
-o bien-
Una entrada de archivo tiene el mismo nombre que una entrada ya extraída del mismo archivo.
El autor de la llamada no tiene el permiso necesario.
destinationDirectoryName tiene un formato no válido.
No se encontró una entrada de archivo o estaba dañada.
-o bien-
Se ha comprimido una entrada de archivo mediante un método de compresión que no se admite.
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.
El directorio especificado por destinationDirectoryName ya puede existir. Este método crea el directorio de destino, sus directorios primarios que faltan y subdirectorios según sea necesario al extraer entradas. Si el archivo está vacío, este método no crea el directorio de destino.
La ruta de acceso puede especificar información de ruta de acceso relativa o absoluta. La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual.
Se aplica a
ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- source
- ZipArchive
- destinationDirectoryName
- String
Ruta de acceso al directorio en el que se van a colocar los archivos extraídos. El directorio ya puede existir. Los directorios que faltan se crean según sea necesario al extraer entradas.
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
Devoluciones
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.
El directorio especificado por destinationDirectoryName ya puede existir. Este método crea el directorio de destino, sus directorios primarios que faltan y subdirectorios según sea necesario al extraer entradas. Si el archivo está vacío, este método no crea el directorio de destino.
Cada archivo extraído tiene la misma ruta de acceso relativa a destinationDirectoryName la que tiene su entrada de origen en la raíz del archivo.
El destinationDirectoryName parámetro acepta rutas de acceso relativas y absolutas. 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, lo que hace que la extracción produzca un IOException si ya existe un archivo.
Use Password para proporcionar la contraseña de las entradas cifradas.
EntryNameEncoding esta sobrecarga no la usa. Los nombres de entrada y los comentarios se descodifican mediante la codificación especificada cuando se abre el source archivo.
Los vínculos simbólicos del archivo no se vuelven a crear como vínculos simbólicos. Si destinationDirectoryName o cualquiera de sus directorios primarios es una unión preexistente o un vínculo simbólico, el vínculo se sigue y la extracción escribe en la carpeta de destino final.
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.
