ZipArchive Costruttori

Definizione

Inizializza una nuova istanza della classe ZipArchive.Initializes a new instance of the ZipArchive class.

Overload

ZipArchive(Stream)

Inizializza una nuova istanza della classe ZipArchive dal flusso specificato.Initializes a new instance of the ZipArchive class from the specified stream.

ZipArchive(Stream, ZipArchiveMode)

Inizializza una nuova istanza della classe ZipArchive dal flusso specificato e con la modalità specificata.Initializes a new instance of the ZipArchive class from the specified stream and with the specified mode.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Inizializza una nuova istanza della classe ZipArchive sulla base del flusso specificato per la modalità specificata. Facoltativamente mantiene aperto il flusso.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)

Inizializza una nuova istanza della classe ZipArchive sulla base del flusso specificato per la modalità specificata. Utilizza la codifica specificata per i nomi delle voci e, facoltativamente mantiene aperto il flusso.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)

Inizializza una nuova istanza della classe ZipArchive dal flusso specificato.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

Parametri

stream
Stream

Flusso che contiene l'archivio da leggere.The stream that contains the archive to be read.

Eccezioni

Il flusso è già chiuso o non supporta la lettura.The stream is already closed or does not support reading.

stream è null.stream is null.

Il contenuto del flusso non è nel formato di archivio ZIP.The contents of the stream are not in the zip archive format.

ZipArchive(Stream, ZipArchiveMode)

Inizializza una nuova istanza della classe ZipArchive dal flusso specificato e con la modalità specificata.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

Parametri

stream
Stream

Flusso di input o output.The input or output stream.

mode
ZipArchiveMode

Uno dei valori di enumerazione che indica se l'archivio ZIP viene utilizzato per leggere, creare o aggiornare le voci.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

Eccezioni

Il flusso è già chiuso o le funzionalità del flusso non corrispondono alla modalità.The stream is already closed, or the capabilities of the stream do not match the mode.

stream è null.stream is null.

modeè un valore non valido.mode is an invalid value.

Il contenuto del flusso non può essere interpretato come archivio ZIP.The contents of the stream could not be interpreted as a zip archive.

-oppure--or- mode è Update e una voce non è presente nell'archivio o è danneggiata e non può essere letta.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

In alternativa-or- mode è Update e una voce è troppo grande per essere contenuta nella memoria.mode is Update and an entry is too large to fit into memory.

Commenti

Se il mode parametro è impostato su Read, il flusso deve supportare la lettura.If the mode parameter is set to Read, the stream must support reading. Se il mode parametro è impostato su Create, il flusso deve supportare la scrittura.If the mode parameter is set to Create, the stream must support writing. Se il mode parametro è impostato su Update, il flusso deve supportare la lettura, la scrittura e la ricerca.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Inizializza una nuova istanza della classe ZipArchive sulla base del flusso specificato per la modalità specificata. Facoltativamente mantiene aperto il flusso.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

Parametri

stream
Stream

Flusso di input o output.The input or output stream.

mode
ZipArchiveMode

Uno dei valori di enumerazione che indica se l'archivio ZIP viene utilizzato per leggere, creare o aggiornare le voci.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

leaveOpen
Boolean

true per mantenere il flusso aperto dopo avere eliminato l'oggetto ZipArchive; in caso contrario, false.true to leave the stream open after the ZipArchive object is disposed; otherwise, false.

Eccezioni

Il flusso è già chiuso o le funzionalità del flusso non corrispondono alla modalità.The stream is already closed, or the capabilities of the stream do not match the mode.

stream è null.stream is null.

modeè un valore non valido.mode is an invalid value.

Il contenuto del flusso non può essere interpretato come archivio ZIP.The contents of the stream could not be interpreted as a zip archive.

-oppure--or- mode è Update e una voce non è presente nell'archivio o è danneggiata e non può essere letta.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

In alternativa-or- mode è Update e una voce è troppo grande per essere contenuta nella memoria.mode is Update and an entry is too large to fit into memory.

Commenti

Se il mode parametro è impostato su Read, il flusso deve supportare la lettura.If the mode parameter is set to Read, the stream must support reading. Se il mode parametro è impostato su Create, il flusso deve supportare la scrittura.If the mode parameter is set to Create, the stream must support writing. Se il mode parametro è impostato su Update, il flusso deve supportare la lettura, la scrittura e la ricerca.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Inizializza una nuova istanza della classe ZipArchive sulla base del flusso specificato per la modalità specificata. Utilizza la codifica specificata per i nomi delle voci e, facoltativamente mantiene aperto il flusso.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

Parametri

stream
Stream

Flusso di input o output.The input or output stream.

mode
ZipArchiveMode

Uno dei valori di enumerazione che indica se l'archivio ZIP viene utilizzato per leggere, creare o aggiornare le voci.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

leaveOpen
Boolean

true per mantenere il flusso aperto dopo avere eliminato l'oggetto ZipArchive; in caso contrario, false.true to leave the stream open after the ZipArchive object is disposed; otherwise, false.

entryNameEncoding
Encoding

La codifica da utilizzare durante la lettura o la scrittura dei nomi delle voci in questo archivio.The encoding to use when reading or writing entry names in this archive. Specificare un valore per il parametro solo quando una codifica è obbligatoria per l'interoperabilità con gli strumenti e le librerie dell'archivio ZIP che non supportano la codifica UTF-8 per i nomi di voce.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.

Eccezioni

Il flusso è già chiuso o le funzionalità del flusso non corrispondono alla modalità.The stream is already closed, or the capabilities of the stream do not match the mode.

stream è null.stream is null.

modeè un valore non valido.mode is an invalid value.

Il contenuto del flusso non può essere interpretato come archivio ZIP.The contents of the stream could not be interpreted as a zip archive.

In alternativa-or- mode è Update e una voce non è presente nell'archivio o è danneggiata e non può essere letta.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

-oppure--or- mode è Update e una voce è troppo grande per essere contenuta nella memoria.mode is Update and an entry is too large to fit into memory.

Commenti

Se il mode parametro è impostato su Read, il flusso deve supportare la lettura.If the mode parameter is set to Read, the stream must support reading. Se il mode parametro è impostato su Create, il flusso deve supportare la scrittura.If the mode parameter is set to Create, the stream must support writing. Se il mode parametro è impostato su Update, il flusso deve supportare la lettura, la scrittura e la ricerca.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

Quando si apre un file di archivio zip per la entryNameEncoding lettura e è nullimpostato su, i nomi di voce vengono decodificati in base alle regole seguenti:When you open a zip archive file for reading and entryNameEncoding is set to null, entry names are decoded according to the following rules:

  • Quando il flag di codifica della lingua (nel flag di bit per utilizzo generico dell'intestazione del file locale) non è impostato, viene utilizzata la tabella codici predefinita del sistema corrente per decodificare il nome della voce.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.

  • Quando viene impostato il flag di codifica della lingua, viene utilizzato UTF-8 per decodificare il nome della voce.When the language encoding flag is set, UTF-8 is used to decode the entry name.

Quando si apre un file di archivio zip per la entryNameEncoding lettura e è impostato su un valore nulldiverso da, i nomi di voce vengono decodificati in base alle regole seguenti: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:

  • Quando il flag di codifica della lingua non è impostato, entryNameEncoding viene usato il parametro specificato per decodificare il nome della voce.When the language encoding flag is not set, the specified entryNameEncoding is used to decode the entry name.

  • Quando viene impostato il flag di codifica della lingua, viene utilizzato UTF-8 per decodificare il nome della voce.When the language encoding flag is set, UTF-8 is used to decode the entry name.

Quando si scrive in file di archivio entryNameEncoding e è impostato nullsu, i nomi di voce vengono codificati in base alle regole seguenti:When you write to archive files and entryNameEncoding is set to null, entry names are encoded according to the following rules:

  • Per i nomi di voce che contengono caratteri non compresi nell'intervallo ASCII, viene impostato il flag di codifica della lingua e i nomi di voce vengono codificati usando 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.

  • Per i nomi di voce che contengono solo caratteri ASCII, il flag di codifica della lingua non è impostato e i nomi di voce vengono codificati usando la tabella codici predefinita del sistema corrente.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.

Quando si scrive in file di archivio entryNameEncoding e è impostato su un valore nulldiverso da, l' entryNameEncoding oggetto specificato viene usato per codificare i nomi di voce in byte.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. Il flag di codifica della lingua (nel flag di bit per utilizzo generico dell'intestazione del file locale) viene impostato solo quando la codifica specificata è una codifica 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.

Si applica a