ZipArchive Constructores

Definición

Inicializa una nueva instancia de la clase ZipArchive.Initializes a new instance of the ZipArchive class.

Sobrecargas

ZipArchive(Stream)

Inicializa una nueva instancia de la clase ZipArchive a partir de la secuencia especificada.Initializes a new instance of the ZipArchive class from the specified stream.

ZipArchive(Stream, ZipArchiveMode)

Inicializa una nueva instancia de la clase ZipArchive a partir de la secuencia especificada y con el modo especificado.Initializes a new instance of the ZipArchive class from the specified stream and with the specified mode.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Inicializa una nueva instancia de la clase ZipArchive en el flujo especificado para el modo especificado y, opcionalmente, deja el flujo abierto.Initializes a new instance of the ZipArchive class on the specified stream for the specified mode, and optionally leaves the stream open.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Inicializa una nueva instancia de la clase ZipArchive en el flujo especificado para el modo especificado, usa la codificación especificada para los nombres de entrada y opcionalmente deja el flujo abierto.Initializes a new instance of the ZipArchive class on the specified stream for the specified mode, uses the specified encoding for entry names, and optionally leaves the stream open.

ZipArchive(Stream)

Inicializa una nueva instancia de la clase ZipArchive a partir de la secuencia especificada.Initializes a new instance of the ZipArchive class from the specified stream.

public:
 ZipArchive(System::IO::Stream ^ stream);
public ZipArchive (System.IO.Stream stream);
new System.IO.Compression.ZipArchive : System.IO.Stream -> System.IO.Compression.ZipArchive

Parámetros

stream
Stream

Secuencia que contiene el archivo que se va a leer.The stream that contains the archive to be read.

Excepciones

La secuencia ya está cerrada no admite lectura.The stream is already closed or does not support reading.

stream es null.stream is null.

El contenido de la secuencia no está en el formato de archivo zip.The contents of the stream are not in the zip archive format.

ZipArchive(Stream, ZipArchiveMode)

Inicializa una nueva instancia de la clase ZipArchive a partir de la secuencia especificada y con el modo especificado.Initializes a new instance of the ZipArchive class from the specified stream and with the specified mode.

public:
 ZipArchive(System::IO::Stream ^ stream, System::IO::Compression::ZipArchiveMode mode);
public ZipArchive (System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode);
new System.IO.Compression.ZipArchive : System.IO.Stream * System.IO.Compression.ZipArchiveMode -> System.IO.Compression.ZipArchive

Parámetros

stream
Stream

Flujo de entrada o de salida.The input or output stream.

mode
ZipArchiveMode

Uno de los valores de enumeración que indica si el archivo zip se usa para leer, crear o actualizar entradas.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

Excepciones

La secuencia ya está cerrada o las funciones de la secuencia no coinciden con el modo.The stream is already closed, or the capabilities of the stream do not match the mode.

stream es null.stream is null.

mode es un valor no válido.mode is an invalid value.

El contenido de la secuencia no se puede interpretar como un archivo zip.The contents of the stream could not be interpreted as a zip archive.

o bien-or- mode es Update y falta una entrada del archivo o está dañada y no se puede leer.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

O bien-or- mode es Update y una entrada es demasiado grande para caber en la memoria.mode is Update and an entry is too large to fit into memory.

Comentarios

Si el mode parámetro se establece en Read, la secuencia debe admitir la lectura.If the mode parameter is set to Read, the stream must support reading. Si el mode parámetro se establece en Create, la secuencia debe admitir la escritura.If the mode parameter is set to Create, the stream must support writing. Si el mode parámetro se establece en Update, la secuencia debe admitir operaciones de lectura, escritura y búsqueda.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Inicializa una nueva instancia de la clase ZipArchive en el flujo especificado para el modo especificado y, opcionalmente, deja el flujo abierto.Initializes a new instance of the ZipArchive class on the specified stream for the specified mode, and optionally leaves the stream open.

public:
 ZipArchive(System::IO::Stream ^ stream, System::IO::Compression::ZipArchiveMode mode, bool leaveOpen);
public ZipArchive (System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode, bool leaveOpen);
new System.IO.Compression.ZipArchive : System.IO.Stream * System.IO.Compression.ZipArchiveMode * bool -> System.IO.Compression.ZipArchive

Parámetros

stream
Stream

Flujo de entrada o de salida.The input or output stream.

mode
ZipArchiveMode

Uno de los valores de enumeración que indica si el archivo zip se usa para leer, crear o actualizar entradas.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

leaveOpen
Boolean

true para dejar el flujo abierto después de desechar el objeto ZipArchive; de lo contrario, false.true to leave the stream open after the ZipArchive object is disposed; otherwise, false.

Excepciones

La secuencia ya está cerrada o las funciones de la secuencia no coinciden con el modo.The stream is already closed, or the capabilities of the stream do not match the mode.

stream es null.stream is null.

mode es un valor no válido.mode is an invalid value.

El contenido de la secuencia no se puede interpretar como un archivo zip.The contents of the stream could not be interpreted as a zip archive.

O bien-or- mode es Update y falta una entrada del archivo o está dañada y no se puede leer.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

o bien-or- mode es Update y una entrada es demasiado grande para caber en la memoria.mode is Update and an entry is too large to fit into memory.

Comentarios

Si el mode parámetro se establece en Read, la secuencia debe admitir la lectura.If the mode parameter is set to Read, the stream must support reading. Si el mode parámetro se establece en Create, la secuencia debe admitir la escritura.If the mode parameter is set to Create, the stream must support writing. Si el mode parámetro se establece en Update, la secuencia debe admitir operaciones de lectura, escritura y búsqueda.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Inicializa una nueva instancia de la clase ZipArchive en el flujo especificado para el modo especificado, usa la codificación especificada para los nombres de entrada y opcionalmente deja el flujo abierto.Initializes a new instance of the ZipArchive class on the specified stream for the specified mode, uses the specified encoding for entry names, and optionally leaves the stream open.

public:
 ZipArchive(System::IO::Stream ^ stream, System::IO::Compression::ZipArchiveMode mode, bool leaveOpen, System::Text::Encoding ^ entryNameEncoding);
public ZipArchive (System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode, bool leaveOpen, System.Text.Encoding entryNameEncoding);
new System.IO.Compression.ZipArchive : System.IO.Stream * System.IO.Compression.ZipArchiveMode * bool * System.Text.Encoding -> System.IO.Compression.ZipArchive

Parámetros

stream
Stream

Flujo de entrada o de salida.The input or output stream.

mode
ZipArchiveMode

Uno de los valores de enumeración que indica si el archivo zip se usa para leer, crear o actualizar entradas.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

leaveOpen
Boolean

true para dejar el flujo abierto después de desechar el objeto ZipArchive; de lo contrario, false.true to leave the stream open after the ZipArchive object is disposed; otherwise, false.

entryNameEncoding
Encoding

Codificación que se va a usar al leer o escribir nombres de entrada en este archivo.The encoding to use when reading or writing entry names in this archive. Especifique un valor para este parámetro únicamente cuando se necesite una codificación para la interoperabilidad con herramientas y bibliotecas de archivos zip que no admiten la codificación UTF-8 para los nombres de entrada.Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names.

Excepciones

La secuencia ya está cerrada o las funciones de la secuencia no coinciden con el modo.The stream is already closed, or the capabilities of the stream do not match the mode.

stream es null.stream is null.

mode es un valor no válido.mode is an invalid value.

El contenido de la secuencia no se puede interpretar como un archivo zip.The contents of the stream could not be interpreted as a zip archive.

O bien-or- mode es Update y falta una entrada del archivo o está dañada y no se puede leer.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

o bien-or- mode es Update y una entrada es demasiado grande para caber en la memoria.mode is Update and an entry is too large to fit into memory.

Comentarios

Si el mode parámetro se establece en Read, la secuencia debe admitir la lectura.If the mode parameter is set to Read, the stream must support reading. Si el mode parámetro se establece en Create, la secuencia debe admitir la escritura.If the mode parameter is set to Create, the stream must support writing. Si el mode parámetro se establece en Update, la secuencia debe admitir operaciones de lectura, escritura y búsqueda.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

Cuando abre un archivo zip para lectura y entryNameEncoding se establece en null, los nombres de las entradas se descodifican según las reglas siguientes:When you open a zip archive file for reading and entryNameEncoding is set to null, entry names are decoded according to the following rules:

  • Cuando no se establece la marca de codificación de idioma (en la marca de bits de uso general del encabezado de archivo local), se usa la página de códigos predeterminada del sistema actual para descodificar el nombre de la entrada.When the language encoding flag (in the general-purpose bit flag of the local file header) is not set, the current system default code page is used to decode the entry name.

  • Cuando se establece la marca de codificación de idioma, se usa UTF-8 para descodificar el nombre de la entrada.When the language encoding flag is set, UTF-8 is used to decode the entry name.

Cuando se abre un archivo zip para lectura y entryNameEncoding se establece en un valor distinto de null, los nombres de las entradas se descodifican según las reglas siguientes:When you open a zip archive file for reading and entryNameEncoding is set to a value other than null, entry names are decoded according to the following rules:

  • Cuando no se establece la marca de codificación de idioma, el entryNameEncoding especificado se usa para descodificar el nombre de la entrada.When the language encoding flag is not set, the specified entryNameEncoding is used to decode the entry name.

  • Cuando se establece la marca de codificación de idioma, se usa UTF-8 para descodificar el nombre de la entrada.When the language encoding flag is set, UTF-8 is used to decode the entry name.

Cuando se escribe en archivos de almacenamiento entryNameEncoding y se establece nullen, los nombres de entrada se codifican según las reglas siguientes:When you write to archive files and entryNameEncoding is set to null, entry names are encoded according to the following rules:

  • En el caso de los nombres de entrada que contienen caracteres fuera del intervalo ASCII, se establece la marca de codificación de idioma y los nombres de entrada se codifican mediante UTF-8.For entry names that contain characters outside the ASCII range, the language encoding flag is set, and entry names are encoded by using UTF-8.

  • En el caso de los nombres de entrada que solo contienen caracteres ASCII, no se establece la marca de codificación de idioma y los nombres de entrada se codifican utilizando la página de códigos predeterminada del sistema actual.For entry names that contain only ASCII characters, the language encoding flag is not set, and entry names are encoded by using the current system default code page.

Cuando se escribe en archivos de almacenamiento entryNameEncoding y se establece en un valor distinto nullde, el entryNameEncoding especificado se usa para codificar los nombres de entrada en bytes.When you write to archive files and entryNameEncoding is set to a value other than null, the specified entryNameEncoding is used to encode the entry names into bytes. La marca de codificación de idioma (en la marca de bits de uso general del encabezado de archivo local) se establece solo cuando la codificación especificada es una codificación UTF-8.The language encoding flag (in the general-purpose bit flag of the local file header) is set only when the specified encoding is a UTF-8 encoding.

Se aplica a