ZipArchive Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inizializza una nuova istanza della classe ZipArchive.
Overload
| Nome | Descrizione |
|---|---|
| ZipArchive(Stream) |
Inizializza una nuova istanza della ZipArchive classe dal flusso specificato. |
| ZipArchive(Stream, ZipArchiveMode) |
Inizializza una nuova istanza della ZipArchive classe dal flusso specificato e con la modalità specificata. |
| ZipArchive(Stream, ZipArchiveMode, Boolean) |
Inizializza una nuova istanza della ZipArchive classe nel flusso specificato per la modalità specificata e, facoltativamente, lascia aperto il flusso. |
| ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding) |
Inizializza una nuova istanza della ZipArchive classe nel flusso specificato per la modalità specificata, usa la codifica specificata per i nomi delle voci e, facoltativamente, lascia aperto il flusso. |
ZipArchive(Stream)
Inizializza una nuova istanza della ZipArchive classe 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.ZipArchivePublic Sub New (stream As Stream)Parametri
- stream
- Stream
Flusso che contiene l'archivio da leggere.
Eccezioni
Il flusso è già chiuso o non supporta la lettura.
stream è null.
Il contenuto del flusso non è nel formato di archivio ZIP.
Si applica a
ZipArchive(Stream, ZipArchiveMode)
Inizializza una nuova istanza della ZipArchive classe 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.ZipArchivePublic 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 usato per leggere, creare o aggiornare le voci.
Eccezioni
Il flusso è già chiuso o le funzionalità del flusso non corrispondono alla modalità .
stream è null.
mode è un valore non valido.
Impossibile interpretare il contenuto del flusso 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 adattarsi alla memoria.
Commenti
Se il mode parametro è impostato su Read, il flusso deve supportare la lettura. Se il mode parametro è impostato su Create, il flusso deve supportare la scrittura. Se il mode parametro è impostato su Update, il flusso deve supportare la lettura, la scrittura e la ricerca.
Si applica a
ZipArchive(Stream, ZipArchiveMode, Boolean)
Inizializza una nuova istanza della ZipArchive classe nel flusso specificato per la modalità specificata e, facoltativamente, lascia 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.ZipArchivePublic 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 usato per leggere, creare o aggiornare le voci.
- leaveOpen
- Boolean
true per lasciare aperto il flusso dopo l'eliminazione dell'oggetto ZipArchive ; in caso contrario, false.
Eccezioni
Il flusso è già chiuso o le funzionalità del flusso non corrispondono alla modalità .
stream è null.
mode è un valore non valido.
Impossibile interpretare il contenuto del flusso 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 adattarsi alla memoria.
Commenti
Se il mode parametro è impostato su Read, il flusso deve supportare la lettura. Se il mode parametro è impostato su Create, il flusso deve supportare la scrittura. Se il mode parametro è impostato su Update, il flusso deve supportare la lettura, la scrittura e la ricerca.
Si applica a
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)
Inizializza una nuova istanza della ZipArchive classe nel flusso specificato per la modalità specificata, usa la codifica specificata per i nomi delle voci e, facoltativamente, lascia 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.ZipArchivePublic 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 usato per leggere, creare o aggiornare le voci.
- leaveOpen
- Boolean
true per lasciare aperto il flusso dopo l'eliminazione dell'oggetto ZipArchive ; in caso contrario, false.
- entryNameEncoding
- Encoding
Codifica da utilizzare per la lettura o la scrittura di nomi e commenti di voci in questo archivio. Specificare un valore per questo parametro solo quando è necessaria una codifica per l'interoperabilità con gli strumenti e le librerie di archivio ZIP che non supportano la codifica UTF-8 per i nomi o i commenti delle voci.
Eccezioni
Il flusso è già chiuso o le funzionalità del flusso non corrispondono alla modalità .
oppure
Per l'oggetto entryNameEncodingviene specificata una codifica diversa da UTF-8.
stream è null.
mode è un valore non valido.
Impossibile interpretare il contenuto del flusso 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 adattarsi alla memoria.
Commenti
Se il mode parametro è impostato su Read, il flusso deve supportare la lettura. Se il mode parametro è impostato su Create, il flusso deve supportare la scrittura. Se il mode parametro è impostato su Update, il flusso deve supportare la lettura, la scrittura e la ricerca.
Quando si apre un file di archivio ZIP per la lettura e entryNameEncoding viene impostato su null, i nomi delle voci e i commenti vengono decodificati in base alle regole seguenti:
- Quando il flag di codifica della lingua (nel flag di bit generico dell'intestazione del file locale) non è impostato, la tabella codici predefinita del sistema corrente viene usata per decodificare il nome e il commento della voce.
- Quando viene impostato il flag di codifica della lingua, viene usato UTF-8 per decodificare il nome e il commento della voce.
Quando si apre un file di archivio ZIP per la lettura e entryNameEncoding viene impostato su un valore diverso nullda , i nomi delle voci e i commenti vengono decodificati in base alle regole seguenti:
- Quando il flag di codifica della lingua non è impostato, l'oggetto specificato
entryNameEncodingviene usato per decodificare il nome e il commento della voce. - Quando viene impostato il flag di codifica della lingua, viene usato UTF-8 per decodificare il nome e il commento della voce.
Quando si scrive nei file di archiviazione e entryNameEncoding viene impostato su null, i nomi delle voci e i commenti vengono codificati in base alle regole seguenti:
- Per i nomi di voce e i commenti che contengono caratteri esterni all'intervallo ASCII, viene impostato il flag di codifica della lingua e i nomi e i commenti delle voci vengono codificati tramite UTF-8.
- Per i nomi di voce e i commenti che contengono solo caratteri ASCII, il flag di codifica della lingua non è impostato e i nomi e i commenti delle voci vengono codificati usando la tabella codici predefinita del sistema corrente.
Quando si scrive nei file di archiviazione e entryNameEncoding viene impostato su un valore diverso da null, l'oggetto specificato entryNameEncoding viene usato per codificare i nomi di voce e i commenti in byte. Il flag di codifica della lingua (nel flag di bit generico dell'intestazione del file locale) viene impostato solo quando la codifica specificata è una codifica UTF-8.