ZipFileExtensions.CreateEntryFromFileAsync 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í.
Agrega de forma asincrónica un archivo del sistema de archivos al archivo bajo el nombre de entrada especificado.
Sobrecargas
| Nombre | Description |
|---|---|
| CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken) |
Agrega de forma asincrónica un archivo del sistema de archivos al archivo bajo el nombre de entrada especificado. |
| CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken) |
Agrega de forma asincrónica un archivo del sistema de archivos al archivo bajo el nombre de entrada especificado. |
CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken)
Agrega de forma asincrónica un archivo del sistema de archivos al archivo bajo el nombre de entrada especificado.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)Parámetros
- destination
- ZipArchive
Archivo ZIP al que se va a agregar el archivo.
- sourceFileName
- String
Ruta de acceso al archivo del sistema de archivos desde la que se va a copiar. 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.
- entryName
- String
Nombre de la entrada que se va a crear.
- cancellationToken
- CancellationToken
Token de cancelación que se va a supervisar para las solicitudes de cancelación.
Devoluciones
Contenedor para la entrada recién creada.
Excepciones
sourceFileName 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.
-o bien-
entryName es una cadena de longitud cero.
sourceFileName o entryName es null.
En sourceFileName, 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.
El especificado sourceFileName no es válido (por ejemplo, está en una unidad no asignada).
Error de E/S al abrir el archivo especificado por sourceFileName.
sourceFileName especificó un directorio.
-o bien-
El autor de la llamada no tiene el permiso necesario.
No se encontró el archivo especificado en sourceFileName .
sourceFileName está en un formato no válido o zipArchive no admite la escritura.
ZipArchive ya se ha cerrado.
Se cancela una operación asincrónica.
Comentarios
La nueva entrada del archivo contendrá el contenido del archivo.
La última hora de escritura de la entrada de archivo se establece en la hora de última escritura del archivo en el sistema de archivos.
Si ya existe una entrada con el nombre especificado en el archivo, se creará una segunda entrada que tenga un nombre idéntico.
Si el archivo de origen especificado 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). Si ya existe una entrada con el nombre especificado en el archivo, se creará una segunda entrada que tenga un nombre idéntico. Puesto que no se especifica , CompressionLevel se usará el valor predeterminado proporcionado por la implementación del algoritmo de compresión subyacente; el ZipArchive no impondrá su propio valor predeterminado.
(Actualmente, la DeflateStream clase proporciona el algoritmo de compresión subyacente).
Se aplica a
CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken)
Agrega de forma asincrónica un archivo del sistema de archivos al archivo bajo el nombre de entrada especificado.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.IO.Compression.CompressionLevel * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, compressionLevel As CompressionLevel, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)Parámetros
- destination
- ZipArchive
Archivo ZIP al que se va a agregar el archivo.
- sourceFileName
- String
Ruta de acceso al archivo del sistema de archivos desde la que se va a copiar. 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.
- entryName
- String
Nombre de la entrada que se va a crear.
- compressionLevel
- CompressionLevel
Nivel de compresión (velocidad/memoria frente al equilibrio de tamaño comprimido).
- cancellationToken
- CancellationToken
Token de cancelación que se va a supervisar para las solicitudes de cancelación.
Devoluciones
Contenedor para la entrada recién creada.
Excepciones
sourceFileName 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.
-o bien-
entryName es una cadena de longitud cero.
sourceFileName o entryName es null.
En sourceFileName, 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.
El especificado sourceFileName no es válido (por ejemplo, está en una unidad no asignada).
Error de E/S al abrir el archivo especificado por sourceFileName.
sourceFileName especificó un directorio.
-o bien-
El autor de la llamada no tiene el permiso necesario.
No se encontró el archivo especificado en sourceFileName .
sourceFileName está en un formato no válido o zipArchive no admite la escritura.
ZipArchive ya se ha cerrado.
Se cancela una operación asincrónica.
Comentarios
La nueva entrada del archivo contendrá el contenido del archivo.
La última hora de escritura de la entrada de archivo se establece en la hora de última escritura del archivo en el sistema de archivos.
Si ya existe una entrada con el nombre especificado en el archivo, se creará una segunda entrada que tenga un nombre idéntico.
Si el archivo de origen especificado 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). Si ya existe una entrada con el nombre especificado en el archivo, se creará una segunda entrada que tenga un nombre idéntico.
