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. Es posible que el directorio especificado ya exista. |
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.
- 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
El directorio especificado no debe existir. 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.
Este método crea todos los subdirectorios y el directorio especificado si es necesario.
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. Es posible que el directorio especificado ya exista.
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.
- 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 creará todos los subdirectorios y el directorio especificado si es necesario.
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
El directorio especificado no debe existir. 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.
