ZipFile.CreateFromDirectoryAsync Método

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, System.Threading.CancellationToken cancellationToken = default);

static member CreateFromDirectoryAsync : string * System.IO.Stream * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, Optional cancellationToken As CancellationToken = Nothing) As Task

Parámetros

Devoluciones

Excepciones

Comentarios

La estructura de directorios del sistema de archivos se conserva en el archivo. Si el directorio está vacío, se crea un archivo vacío.

Esta sobrecarga del método no incluye el directorio base en el archivo y no permite especificar un nivel de compresión.

Si desea incluir el directorio base o especificar un nivel de compresión, llame a la sobrecarga del CreateFromDirectory(String, Stream, CompressionLevel, Boolean) método.

Si no se puede agregar un archivo en el directorio al archivo, el archivo se deja incompleto y no es válido, y el método produce una IOException excepción.

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationArchiveFileName, System.Threading.CancellationToken cancellationToken = default);

static member CreateFromDirectoryAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationArchiveFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parámetros

Devoluciones

Excepciones

Comentarios

La estructura de directorios se conserva en el archivo y se realiza una búsqueda recursiva para que los archivos se archiven. El archivo no debe existir. Si el directorio está vacío, se crea un archivo vacío. Si no se puede agregar un archivo en el directorio al archivo, el archivo dejará incompleto y no válido y el método producirá una excepción. Este método no incluye el directorio base en el archivo.

Si se produce un error al agregar archivos al archivo, este método deja de agregar archivos y deja el archivo en un estado no válido. Las rutas de acceso pueden 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 un archivo del archivo tiene datos en el campo de hora de última escritura que no es una marca de tiempo zip válida, se usará un valor de indicador del 1980 de enero de 1980 a medianoche para la hora de la última modificación del archivo. Si ya existe una entrada con el nombre especificado en el archivo, se crea una segunda entrada que tiene un nombre idéntico. Dado que no se especifica , CompressionLevel se usa el valor predeterminado proporcionado por la implementación del algoritmo de compresión subyacente; el ZipArchive no impone su propio valor predeterminado.

(Actualmente, la DeflateStream clase proporciona el algoritmo de compresión subyacente).

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

static member CreateFromDirectoryAsync : string * System.IO.Stream * System.IO.Compression.CompressionLevel * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parámetros

Devoluciones

Excepciones

Comentarios

La estructura de directorios del sistema de archivos se conserva en el archivo. Si el directorio está vacío, se crea un archivo vacío.

Use esta sobrecarga de método para especificar el nivel de compresión y si se debe incluir el directorio base en el archivo.

Si no se puede agregar un archivo en el directorio al archivo, el archivo se deja incompleto y no es válido, y el método produce una IOException excepción.

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

static member CreateFromDirectoryAsync : string * string * System.IO.Compression.CompressionLevel * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationArchiveFileName As String, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parámetros

Devoluciones

Excepciones

Comentarios

La estructura de directorios se conserva en el archivo y se realiza una búsqueda recursiva para que los archivos se archiven. El archivo no debe existir. Si el directorio está vacío, se creará un archivo vacío.

Si no se puede agregar un archivo en el directorio al archivo, el archivo dejará incompleto y no válido y el método producirá una excepción. Este método incluye opcionalmente el directorio base en el archivo.

Si se produce un error al agregar archivos al archivo, este método dejará de agregar archivos y dejará el archivo en un estado no válido. Las rutas de acceso pueden 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 un archivo del archivo tiene datos en el campo de hora de última escritura que no es una marca de tiempo zip válida, se usará un valor de indicador del 1980 de enero de 1980 a medianoche para la hora de la última modificación del archivo. 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).

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);

static member CreateFromDirectoryAsync : string * System.IO.Stream * System.IO.Compression.CompressionLevel * bool * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parámetros

Devoluciones

Excepciones

Comentarios

La estructura de directorios del sistema de archivos se conserva en el archivo. Si el directorio está vacío, se crea un archivo vacío.

Use esta sobrecarga de método para especificar el nivel de compresión y la codificación de caracteres y si se debe incluir el directorio base en el archivo.

Si no se puede agregar un archivo en el directorio al archivo, el archivo se deja incompleto y no es válido, y el método produce una IOException excepción.

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);

static member CreateFromDirectoryAsync : string * string * System.IO.Compression.CompressionLevel * bool * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationArchiveFileName As String, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parámetros

Devoluciones

Excepciones

Comentarios

La estructura de directorios se conserva en el archivo y se realiza una búsqueda recursiva para que los archivos se archiven. El archivo no debe existir. Si el directorio está vacío, se creará un archivo vacío.

Si no se puede agregar un archivo en el directorio al archivo, el archivo dejará incompleto y no válido y el método producirá una excepción. Este método incluye opcionalmente el directorio base en el archivo.

Si se produce un error al agregar archivos al archivo, este método dejará de agregar archivos y dejará el archivo en un estado no válido. Las rutas de acceso pueden 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 un archivo del archivo tiene datos en el campo de hora de última escritura que no es una marca de tiempo zip válida, se usará un valor de indicador del 1980 de enero de 1980 a medianoche para la hora de la última modificación del archivo. 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).

No se recomienda especificar un valor para entryNameEncoding otro que null no sea .

Sin embargo, esto puede ser necesario para la interoperabilidad con las herramientas y bibliotecas de archivo zip que no admiten correctamente la codificación UTF-8 para nombres de entrada o comentarios.

• Si entryNameEncoding no se especifica (== null):
  • Para los nombres de archivo o comentarios que contienen caracteres fuera del intervalo ASCII:
    La marca de codificación de idioma (EFS) se establecerá en la marca de bits de uso general del encabezado de archivo local de la entrada correspondiente y se usará UTF-8 (Encoding.UTF8) para codificar el nombre de entrada y el comentario en bytes.
  • Para los nombres de archivo o comentarios que no contienen caracteres fuera del intervalo ASCII:
    La marca de codificación de idioma (EFS) no se establecerá en la marca de bits de uso general del encabezado de archivo local de la entrada correspondiente y la página de códigos predeterminada del sistema actual (Encoding.Default) se usará para codificar los nombres de entrada y los comentarios en bytes.
• Si entryNameEncoding se especifica (!= null):
  • El especificado entryNameEncoding siempre se usará para codificar los nombres de entrada y los comentarios en bytes.
    La marca de codificación de idioma (EFS) en la marca de bits de uso general del encabezado de archivo local para cada entrada se establecerá si y solo si el especificado entryNameEncoding es una codificación UTF-8.

Las codificaciones Unicode que no sean UTF-8 no se pueden usar para entryNameEncoding, de lo contrario, se produce una ArgumentException excepción .