ZipArchive Constructeurs

Définition

Espace de noms:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Initialise une nouvelle instance de la classe ZipArchive.

Surcharges

ZipArchive(Stream)	Initialise une nouvelle instance de la classe ZipArchive à partir du flux spécifié.
ZipArchive(Stream, ZipArchiveMode)	Initialise une nouvelle instance de la classe ZipArchive à partir du flux spécifié et avec le mode spécifié.
ZipArchive(Stream, ZipArchiveMode, Boolean)	Initialise une nouvelle instance de la classe ZipArchive sur le flux de données spécifié pour le mode spécifié, et laisse éventuellement le flux ouvert.
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)	Initialise une nouvelle instance de la classe ZipArchive sur le flux spécifié pour le mode spécifié, utilise l’encodage spécifié pour les noms d’entrée, et permet éventuellement de laisser le flux ouvert.

ZipArchive(Stream)

Source:

ZipArchive.cs

Initialise une nouvelle instance de la classe ZipArchive à 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.ZipArchive

Public Sub New (stream As Stream)

Paramètres

stream

Stream

Flux qui contient l'archive à lire.

Exceptions

ArgumentException

Le flux ne prend pas en charge l’écriture ou bien il est déjà fermé.

ArgumentNullException

stream a la valeur null.

InvalidDataException

Le contenu du flux de données n’est pas au format d’archivage ZIP.

ZipArchive(Stream, ZipArchiveMode)

Source:

ZipArchive.cs

Initialise une nouvelle instance de la classe ZipArchive à 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.ZipArchive

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

Paramètres

stream

Stream

Flux de sortie ou d'entrée.

mode

ZipArchiveMode

L'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

ArgumentException

Le flux de données est déjà fermé, ou les fonctions du flux de données ne correspondent pas au mode.

ArgumentNullException

stream a la valeur null.

ArgumentOutOfRangeException

mode n’est pas une valeur valide.

InvalidDataException

Le contenu du flux de données n’a pas pu être interprété comme une archive ZIP.

- ou -

mode est Update et l’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 être contenue dans la mémoire.

Remarques

Si le mode paramètre est défini sur Read, le flux doit prendre en charge la lecture. Si le mode paramètre est défini sur Create, le flux doit prendre en charge l’écriture. Si le mode paramètre est défini sur Update, le flux doit prendre en charge la lecture, l’écriture et la recherche.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Source:

ZipArchive.cs

Initialise une nouvelle instance de la classe ZipArchive sur le flux de données 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.ZipArchive

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

Paramètres

stream

Stream

Flux de sortie ou d'entrée.

mode

ZipArchiveMode

L'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 maintenir le flux ouvert après avoir supprimé l'objet ZipArchive ; sinon, false.

Exceptions

ArgumentException

Le flux de données est déjà fermé, ou les fonctions du flux de données ne correspondent pas au mode.

ArgumentNullException

stream a la valeur null.

ArgumentOutOfRangeException

mode n’est pas une valeur valide.

InvalidDataException

Le contenu du flux de données n’a pas pu être interprété comme une archive ZIP.

- ou -

mode est Update et l’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 être contenue dans la mémoire.

Remarques

Si le mode paramètre est défini sur Read, le flux doit prendre en charge la lecture. Si le mode paramètre est défini sur Create, le flux doit prendre en charge l’écriture. Si le mode paramètre est défini sur Update, le flux doit prendre en charge la lecture, l’écriture et la recherche.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Source:

ZipArchive.cs

Initialise une nouvelle instance de la classe ZipArchive sur le flux spécifié pour le mode spécifié, utilise l’encodage spécifié pour les noms d’entrée, et permet éventuellement de laisser 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.ZipArchive

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

Paramètres

stream

Stream

Flux de sortie ou d'entrée.

mode

ZipArchiveMode

L'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 maintenir le flux ouvert après avoir supprimé l'objet ZipArchive ; sinon, false.

entryNameEncoding

Encoding

Encodage à utiliser lors de la lecture ou de l'écriture des noms d'entrée dans cette archive. Spécifie une valeur pour ce paramètre uniquement lorsqu'un encodage est obligatoire pour l'interopérabilité avec les outils et les bibliothèques d'archivage de zip qui ne prennent pas en charge l'encodage UTF-8 pour les noms d'entrée.

Exceptions

ArgumentException

Le flux de données est déjà fermé, ou les fonctions du flux de données ne correspondent pas au mode.

- ou -

Un encodage autre qu’UTF-8 est spécifié pour entryNameEncoding.

ArgumentNullException

stream a la valeur null.

ArgumentOutOfRangeException

mode n’est pas une valeur valide.

InvalidDataException

Le contenu du flux de données n’a pas pu être interprété comme une archive ZIP.

- ou -

mode est Update et l’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 être contenue dans la mémoire.

Remarques

Si le mode paramètre est défini sur Read, le flux doit prendre en charge la lecture. Si le mode paramètre est défini sur Create, le flux doit prendre en charge l’écriture. Si le mode paramètre est défini sur Update, le flux doit prendre en charge la lecture, l’écriture et la recherche.

Lorsque vous ouvrez un fichier d’archive zip pour la lecture et entryNameEncoding que est défini sur null, les noms d’entrée sont décodés selon les règles suivantes :

• Lorsque l’indicateur d’encodage de langue (dans l’indicateur de bits à usage général 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 de l’entrée.

• Lorsque l’indicateur d’encodage de langue est défini, UTF-8 est utilisé pour décoder le nom de l’entrée.

Lorsque vous ouvrez un fichier d’archive zip à des fins de lecture et entryNameEncoding que est défini sur une valeur autre que null, les noms d’entrée sont décodés conformément aux règles suivantes :

• Lorsque l’indicateur d’encodage de langue n’est pas défini, le spécifié entryNameEncoding est utilisé pour décoder le nom de l’entrée.

• Lorsque l’indicateur d’encodage de langue est défini, UTF-8 est utilisé pour décoder le nom de l’entrée.

Lorsque vous écrivez dans des fichiers d’archivage et entryNameEncoding que est défini sur null, les noms d’entrée sont encodés selon les règles suivantes :

• Pour les noms d’entrée 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 sont encodés à l’aide de UTF-8.

• Pour les noms d’entrée qui contiennent uniquement des caractères ASCII, l’indicateur d’encodage de langue n’est pas défini et les noms d’entrée 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 est défini sur une valeur autre que null, le spécifié entryNameEncoding est utilisé pour encoder les noms d’entrée en octets. L’indicateur d’encodage de langue (dans l’indicateur de bits à usage général de l’en-tête de fichier local) est défini uniquement lorsque l’encodage spécifié est un encodage UTF-8.