ZipArchive Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de la classe ZipArchive.
Surcharges
| Nom | Description |
|---|---|
| ZipArchive(Stream) |
Initialise une nouvelle instance de la ZipArchive classe à partir du flux spécifié. |
| ZipArchive(Stream, ZipArchiveMode) |
Initialise une nouvelle instance de la ZipArchive classe à partir du flux spécifié et avec le mode spécifié. |
| ZipArchive(Stream, ZipArchiveMode, Boolean) |
Initialise une nouvelle instance de la ZipArchive classe sur le flux spécifié pour le mode spécifié et laisse éventuellement le flux ouvert. |
| ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding) |
Initialise une nouvelle instance de la ZipArchive classe sur le flux spécifié pour le mode spécifié, utilise l’encodage spécifié pour les noms d’entrée et laisse éventuellement le flux ouvert. |
ZipArchive(Stream)
Initialise une nouvelle instance de la ZipArchive classe à partir du flux spécifié.
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)Paramètres
- stream
- Stream
Flux qui contient l’archive à lire.
Exceptions
Le flux est déjà fermé ou ne prend pas en charge la lecture.
stream a la valeur null.
Le contenu du flux ne se trouve pas dans le format d’archivage zip.
S’applique à
ZipArchive(Stream, ZipArchiveMode)
Initialise une nouvelle instance de la ZipArchive classe à partir du flux spécifié et avec le mode spécifié.
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)Paramètres
- stream
- Stream
Flux d’entrée ou de sortie.
- mode
- ZipArchiveMode
Une des valeurs d’énumération qui indique si l’archive zip est utilisée pour lire, créer ou mettre à jour des entrées.
Exceptions
Le flux est déjà fermé ou les fonctionnalités du flux ne correspondent pas au mode.
stream a la valeur null.
mode est une valeur non valide.
Le contenu du flux n’a pas pu être interprété comme une archive zip.
-ou-
mode est Update et une entrée est manquante dans l’archive ou est endommagée et ne peut pas être lue.
-ou-
mode est Update et une entrée est trop grande pour s’adapter à la mémoire.
Remarques
Si le mode paramètre est défini Readsur , le flux doit prendre en charge la lecture. Si le mode paramètre est défini Createsur , le flux doit prendre en charge l’écriture. Si le mode paramètre est défini Updatesur , le flux doit prendre en charge la lecture, l’écriture et la recherche.
S’applique à
ZipArchive(Stream, ZipArchiveMode, Boolean)
Initialise une nouvelle instance de la ZipArchive classe sur le flux spécifié pour le mode spécifié et laisse éventuellement le flux ouvert.
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)Paramètres
- stream
- Stream
Flux d’entrée ou de sortie.
- mode
- ZipArchiveMode
Une des valeurs d’énumération qui indique si l’archive zip est utilisée pour lire, créer ou mettre à jour des entrées.
- leaveOpen
- Boolean
true pour laisser le flux ouvert une fois l’objet ZipArchive supprimé ; sinon, false.
Exceptions
Le flux est déjà fermé ou les fonctionnalités du flux ne correspondent pas au mode.
stream a la valeur null.
mode est une valeur non valide.
Le contenu du flux n’a pas pu être interprété comme une archive zip.
-ou-
mode est Update et une entrée est manquante dans l’archive ou est endommagée et ne peut pas être lue.
-ou-
mode est Update et une entrée est trop grande pour s’adapter à la mémoire.
Remarques
Si le mode paramètre est défini Readsur , le flux doit prendre en charge la lecture. Si le mode paramètre est défini Createsur , le flux doit prendre en charge l’écriture. Si le mode paramètre est défini Updatesur , le flux doit prendre en charge la lecture, l’écriture et la recherche.
S’applique à
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)
Initialise une nouvelle instance de la ZipArchive classe sur le flux spécifié pour le mode spécifié, utilise l’encodage spécifié pour les noms d’entrée et laisse éventuellement le flux ouvert.
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)Paramètres
- stream
- Stream
Flux d’entrée ou de sortie.
- mode
- ZipArchiveMode
Une des valeurs d’énumération qui indique si l’archive zip est utilisée pour lire, créer ou mettre à jour des entrées.
- leaveOpen
- Boolean
true pour laisser le flux ouvert une fois l’objet ZipArchive supprimé ; sinon, false.
- entryNameEncoding
- Encoding
Encodage à utiliser lors de la lecture ou de l’écriture de noms et de commentaires d’entrée dans cette archive. Spécifiez une valeur pour ce paramètre uniquement lorsqu’un encodage est requis pour l’interopérabilité avec les outils et bibliothèques d’archive zip qui ne prennent pas en charge l’encodage UTF-8 pour les noms d’entrée ou les commentaires.
Exceptions
Le flux est déjà fermé ou les fonctionnalités du flux ne correspondent pas au mode.
-ou-
Un encodage autre que UTF-8 est spécifié pour le entryNameEncoding.
stream a la valeur null.
mode est une valeur non valide.
Le contenu du flux n’a pas pu être interprété comme une archive zip.
-ou-
mode est Update et une entrée est manquante dans l’archive ou est endommagée et ne peut pas être lue.
-ou-
mode est Update et une entrée est trop grande pour s’adapter à la mémoire.
Remarques
Si le mode paramètre est défini Readsur , le flux doit prendre en charge la lecture. Si le mode paramètre est défini Createsur , le flux doit prendre en charge l’écriture. Si le mode paramètre est défini Updatesur , le flux doit prendre en charge la lecture, l’écriture et la recherche.
Lorsque vous ouvrez un fichier d’archivage zip pour la lecture et entryNameEncoding est défini nullsur , les noms d’entrée et les commentaires sont décodés conformément aux règles suivantes :
- Lorsque l’indicateur d’encodage de langue (dans l’indicateur de bits universel de l’en-tête de fichier local) n’est pas défini, la page de codes système par défaut actuelle est utilisée pour décoder le nom et le commentaire d’entrée.
- Lorsque l’indicateur d’encodage de langue est défini, UTF-8 est utilisé pour décoder le nom et le commentaire d’entrée.
Lorsque vous ouvrez un fichier d’archivage zip pour la lecture et entryNameEncoding est défini sur une valeur autre que null, les noms d’entrée et les commentaires sont décodés conformément aux règles suivantes :
- Lorsque l’indicateur d’encodage de langue n’est pas défini, l’indicateur
entryNameEncodingspécifié est utilisé pour décoder le nom et le commentaire d’entrée. - Lorsque l’indicateur d’encodage de langue est défini, UTF-8 est utilisé pour décoder le nom et le commentaire d’entrée.
Lorsque vous écrivez dans des fichiers d’archivage et entryNameEncoding que nullvous définissez sur , les noms d’entrée et les commentaires sont encodés en fonction des règles suivantes :
- Pour les noms d’entrée et les commentaires qui contiennent des caractères en dehors de la plage ASCII, l’indicateur d’encodage de langue est défini et les noms d’entrée et les commentaires sont encodés à l’aide de UTF-8.
- Pour les noms d’entrée et les commentaires qui contiennent uniquement des caractères ASCII, l’indicateur d’encodage de langue n’est pas défini et les noms d’entrée et les commentaires sont encodés à l’aide de la page de codes système par défaut actuelle.
Lorsque vous écrivez dans des fichiers d’archivage et entryNameEncoding que vous définissez sur une valeur autre que null, la valeur spécifiée entryNameEncoding est utilisée pour encoder les noms d’entrée et les commentaires en octets. L’indicateur d’encodage de langue (dans l’indicateur de bits universel de l’en-tête de fichier local) est défini uniquement lorsque l’encodage spécifié est un encodage UTF-8.