ZipArchive Costruttori

Definizione

Spazio dei nomi:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Inizializza una nuova istanza della classe ZipArchive.

Overload

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

ZipArchive(Stream)

Origine:

ZipArchive.cs

Inizializza una nuova istanza della classe ZipArchive dal flusso specificato.

public:
 ZipArchive(System::IO::Stream ^ stream);

public ZipArchive (System.IO.Stream stream);

new System.IO.Compression.ZipArchive : System.IO.Stream -> System.IO.Compression.ZipArchive

Public Sub New (stream As Stream)

Parametri

stream

Stream

Flusso che contiene l'archivio da leggere.

Eccezioni

ArgumentException

Il flusso è già chiuso o non supporta la lettura.

ArgumentNullException

stream è null.

InvalidDataException

Il contenuto del flusso non è nel formato di archivio ZIP.

ZipArchive(Stream, ZipArchiveMode)

Origine:

ZipArchive.cs

Inizializza una nuova istanza della classe ZipArchive dal flusso specificato e con la modalità specificata.

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

Public Sub New (stream As Stream, mode As ZipArchiveMode)

Parametri

stream

Stream

Flusso di input o output.

mode

ZipArchiveMode

Uno dei valori di enumerazione che indica se l'archivio ZIP viene utilizzato per leggere, creare o aggiornare le voci.

Eccezioni

ArgumentException

Il flusso è già chiuso o le funzionalità del flusso non corrispondono alla modalità.

ArgumentNullException

stream è null.

ArgumentOutOfRangeException

modeè un valore non valido.

InvalidDataException

Il contenuto del flusso non può essere interpretato come archivio ZIP.

-oppure-

mode è Update e una voce non è presente nell'archivio o è danneggiata e non può essere letta.

-oppure-

mode è Update e una voce è troppo grande per essere contenuta nella memoria.

Commenti

Se il parametro è impostato su Read, il mode flusso deve supportare la lettura. Se il parametro è impostato su Create, il flusso deve supportare la mode scrittura. Se il parametro è impostato su Update, il flusso deve supportare la lettura, la scrittura e la mode ricerca.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Origine:

ZipArchive.cs

Inizializza una nuova istanza della classe ZipArchive sulla base del flusso specificato per la modalità specificata. Facoltativamente mantiene aperto il flusso.

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

Public Sub New (stream As Stream, mode As ZipArchiveMode, leaveOpen As Boolean)

Parametri

stream

Stream

Flusso di input o output.

mode

ZipArchiveMode

Uno dei valori di enumerazione che indica se l'archivio ZIP viene utilizzato per leggere, creare o aggiornare le voci.

leaveOpen

Boolean

true per mantenere il flusso aperto dopo avere eliminato l'oggetto ZipArchive; in caso contrario, false.

Eccezioni

ArgumentException

Il flusso è già chiuso o le funzionalità del flusso non corrispondono alla modalità.

ArgumentNullException

stream è null.

ArgumentOutOfRangeException

modeè un valore non valido.

InvalidDataException

Il contenuto del flusso non può essere interpretato come archivio ZIP.

-oppure-

mode è Update e una voce non è presente nell'archivio o è danneggiata e non può essere letta.

-oppure-

mode è Update e una voce è troppo grande per essere contenuta nella memoria.

Commenti

Se il parametro è impostato su Read, il mode flusso deve supportare la lettura. Se il parametro è impostato su Create, il flusso deve supportare la mode scrittura. Se il parametro è impostato su Update, il flusso deve supportare la lettura, la scrittura e la mode ricerca.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Origine:

ZipArchive.cs

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.

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

Public Sub New (stream As Stream, mode As ZipArchiveMode, leaveOpen As Boolean, entryNameEncoding As Encoding)

Parametri

stream

Stream

Flusso di input o output.

mode

ZipArchiveMode

Uno dei valori di enumerazione che indica se l'archivio ZIP viene utilizzato per leggere, creare o aggiornare le voci.

leaveOpen

Boolean

true per mantenere il flusso aperto dopo avere eliminato l'oggetto ZipArchive; in caso contrario, false.

entryNameEncoding

Encoding

La codifica da utilizzare durante la lettura o la scrittura dei nomi delle voci in questo archivio. 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.

Eccezioni

ArgumentException

Il flusso è già chiuso o le funzionalità del flusso non corrispondono alla modalità.

-oppure-

Per entryNameEncoding è specificata una codifica diversa da UTF-8.

ArgumentNullException

stream è null.

ArgumentOutOfRangeException

modeè un valore non valido.

InvalidDataException

Il contenuto del flusso non può essere interpretato come archivio ZIP.

-oppure-

mode è Update e una voce non è presente nell'archivio o è danneggiata e non può essere letta.

-oppure-

mode è Update e una voce è troppo grande per essere contenuta nella memoria.

Commenti

Se il parametro è impostato su Read, il mode flusso deve supportare la lettura. Se il parametro è impostato su Create, il flusso deve supportare la mode scrittura. Se il parametro è impostato su Update, il flusso deve supportare la lettura, la scrittura e la mode ricerca.

Quando si apre un file di archivio zip per la lettura ed entryNameEncoding è impostato su null, i nomi di voce vengono decodificati in base alle regole seguenti:

• Quando il flag di codifica del linguaggio (nel flag a bit generico dell'intestazione del file locale) non è impostato, la tabella codici predefinita del sistema corrente viene usata per decodificare il nome della voce.

• Quando viene impostato il flag di codifica del linguaggio, viene usato UTF-8 per decodificare il nome della voce.

Quando si apre un file di archivio zip per la lettura e entryNameEncoding viene impostato su un valore diverso nullda , i nomi di voce vengono decodificati in base alle regole seguenti:

• Quando il flag di codifica del linguaggio non è impostato, viene entryNameEncoding usato per decodificare il nome della voce.

• Quando viene impostato il flag di codifica del linguaggio, viene usato UTF-8 per decodificare il nome della voce.

Quando si scrive nei file di archiviazione ed entryNameEncoding è impostato su null, i nomi di voce vengono codificati in base alle regole seguenti:

• Per i nomi di voce che contengono caratteri all'esterno dell'intervallo ASCII, il flag di codifica del linguaggio è impostato e i nomi di voce vengono codificati usando UTF-8.

• Per i nomi di voce che contengono solo caratteri ASCII, il flag di codifica del linguaggio non è impostato e i nomi di voce vengono codificati usando la tabella codici predefinita del sistema corrente.

Quando si scrive in file di archiviazione e entryNameEncoding viene impostato su un valore diverso nullda , viene entryNameEncoding usato per codificare i nomi di voce in byte. Il flag di codifica del linguaggio (nel flag a bit generico dell'intestazione del file locale) viene impostato solo quando la codifica specificata è una codifica UTF-8.