ZipArchive ZipArchive ZipArchive Constructors

Définition

Surcharges

ZipArchive(Stream) ZipArchive(Stream) ZipArchive(Stream)

Initialise une nouvelle instance de la classe ZipArchive à partir du flux spécifié.Initializes a new instance of the ZipArchive class from the specified stream.

ZipArchive(Stream, ZipArchiveMode) ZipArchive(Stream, ZipArchiveMode) ZipArchive(Stream, ZipArchiveMode)

Initialise une nouvelle instance de la classe ZipArchive à partir du flux spécifié et avec le mode spécifié.Initializes a new instance of the ZipArchive class from the specified stream and with the specified mode.

ZipArchive(Stream, ZipArchiveMode, Boolean) ZipArchive(Stream, ZipArchiveMode, Boolean) 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.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) ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding) 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.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) ZipArchive(Stream) ZipArchive(Stream)

Initialise une nouvelle instance de la classe ZipArchive à partir du flux spécifié.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

Paramètres

stream
Stream Stream Stream

Flux qui contient l'archive à lire.The stream that contains the archive to be read.

Exceptions

Le flux ne prend pas en charge l’écriture ou bien il est déjà fermé.The stream is already closed or does not support reading.

stream a la valeur null.stream is null.

Le contenu du flux de données n’est pas au format d’archivage ZIP.The contents of the stream are not in the zip archive format.

ZipArchive(Stream, ZipArchiveMode) ZipArchive(Stream, ZipArchiveMode) ZipArchive(Stream, ZipArchiveMode)

Initialise une nouvelle instance de la classe ZipArchive à partir du flux spécifié et avec le mode spécifié.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

Paramètres

stream
Stream Stream Stream

Flux de sortie ou d'entrée.The input or output stream.

mode
ZipArchiveMode ZipArchiveMode 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.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

Exceptions

Le flux de données est déjà fermé, ou les fonctions du flux de données ne correspondent pas au mode.The stream is already closed, or the capabilities of the stream do not match the mode.

stream a la valeur null.stream is null.

mode n’est pas une valeur valide.mode is an invalid value.

Le contenu du flux de données n’a pas pu être interprété comme une archive ZIP.The contents of the stream could not be interpreted as a zip archive.

- ou --or- mode est Update et l’entrée est manquante dans l’archive, ou est endommagée et ne peut pas être lue.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

- ou --or- mode est Update et une entrée est trop grande pour être contenue dans la mémoire.mode is Update and an entry is too large to fit into memory.

Remarques

Si le mode paramètre a la Readvaleur, le flux doit prendre en charge la lecture.If the mode parameter is set to Read, the stream must support reading. Si le mode paramètre a la Createvaleur, le flux doit prendre en charge l’écriture.If the mode parameter is set to Create, the stream must support writing. Si le mode paramètre a la Updatevaleur, le flux doit prendre en charge la lecture, l’écriture et la recherche.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

ZipArchive(Stream, ZipArchiveMode, Boolean) ZipArchive(Stream, ZipArchiveMode, Boolean) 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.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

Paramètres

stream
Stream Stream Stream

Flux de sortie ou d'entrée.The input or output stream.

mode
ZipArchiveMode ZipArchiveMode 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.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

leaveOpen
Boolean Boolean Boolean

true pour maintenir le flux ouvert après avoir supprimé l'objet ZipArchive ; sinon, false.true to leave the stream open after the ZipArchive object is disposed; otherwise, false.

Exceptions

Le flux de données est déjà fermé, ou les fonctions du flux de données ne correspondent pas au mode.The stream is already closed, or the capabilities of the stream do not match the mode.

mode n’est pas une valeur valide.mode is an invalid value.

Le contenu du flux de données n’a pas pu être interprété comme une archive ZIP.The contents of the stream could not be interpreted as a zip archive.

- ou --or- mode est Update et l’entrée est manquante dans l’archive, ou est endommagée et ne peut pas être lue.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

- ou --or- mode est Update et une entrée est trop grande pour être contenue dans la mémoire.mode is Update and an entry is too large to fit into memory.

Remarques

Si le mode paramètre a la Readvaleur, le flux doit prendre en charge la lecture.If the mode parameter is set to Read, the stream must support reading. Si le mode paramètre a la Createvaleur, le flux doit prendre en charge l’écriture.If the mode parameter is set to Create, the stream must support writing. Si le mode paramètre a la Updatevaleur, le flux doit prendre en charge la lecture, l’écriture et la recherche.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding) ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding) 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.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

Paramètres

stream
Stream Stream Stream

Flux de sortie ou d'entrée.The input or output stream.

mode
ZipArchiveMode ZipArchiveMode 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.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

leaveOpen
Boolean Boolean Boolean

true pour maintenir le flux ouvert après avoir supprimé l'objet ZipArchive ; sinon, false.true to leave the stream open after the ZipArchive object is disposed; otherwise, false.

entryNameEncoding
Encoding Encoding Encoding

Encodage à utiliser lors de la lecture ou de l'écriture des noms d'entrée dans cette archive.The encoding to use when reading or writing entry names in this 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.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.

Exceptions

Le flux de données est déjà fermé, ou les fonctions du flux de données ne correspondent pas au mode.The stream is already closed, or the capabilities of the stream do not match the mode.

stream a la valeur null.stream is null.

mode n’est pas une valeur valide.mode is an invalid value.

Le contenu du flux de données n’a pas pu être interprété comme une archive ZIP.The contents of the stream could not be interpreted as a zip archive.

- ou --or- mode est Update et l’entrée est manquante dans l’archive, ou est endommagée et ne peut pas être lue.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

ou-or- mode est Update et une entrée est trop grande pour être contenue dans la mémoire.mode is Update and an entry is too large to fit into memory.

Remarques

Si le mode paramètre a la Readvaleur, le flux doit prendre en charge la lecture.If the mode parameter is set to Read, the stream must support reading. Si le mode paramètre a la Createvaleur, le flux doit prendre en charge l’écriture.If the mode parameter is set to Create, the stream must support writing. Si le mode paramètre a la Updatevaleur, le flux doit prendre en charge la lecture, l’écriture et la recherche.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

Lorsque vous ouvrez un fichier d’archive zip pour la entryNameEncoding lecture et que nulla la valeur, les noms d’entrée sont décodés selon les règles suivantes:When you open a zip archive file for reading and entryNameEncoding is set to null, entry names are decoded according to the following rules:

  • Lorsque l’indicateur d’encodage linguistique (dans l’indicateur de bit à usage général de l’en-tête de fichier local) n’est pas défini, la page de codes par défaut du système actuelle est utilisée pour décoder le nom de l’entrée.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.

  • Lorsque l’indicateur d’encodage linguistique est défini, UTF-8 est utilisé pour décoder le nom de l’entrée.When the language encoding flag is set, UTF-8 is used to decode the entry name.

Lorsque vous ouvrez un fichier d’archive zip pour la entryNameEncoding lecture et que a une valeur autre nullque, les noms d’entrée sont décodés selon les règles suivantes: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:

  • Lorsque l’indicateur d’encodage de la langue n’est entryNameEncoding pas défini, le spécifié est utilisé pour décoder le nom de l’entrée.When the language encoding flag is not set, the specified entryNameEncoding is used to decode the entry name.

  • Lorsque l’indicateur d’encodage linguistique est défini, UTF-8 est utilisé pour décoder le nom de l’entrée.When the language encoding flag is set, UTF-8 is used to decode the entry name.

Lorsque vous écrivez dans des fichiers d' entryNameEncoding Archive et que nulla la valeur, les noms d’entrée sont encodés selon les règles suivantes:When you write to archive files and entryNameEncoding is set to null, entry names are encoded according to the following rules:

  • 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 d’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.

  • 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 par défaut du système actuelle.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.

Lorsque vous écrivez dans des fichiers d' entryNameEncoding Archive et que est défini sur une nullvaleur autre que entryNameEncoding , le spécifié est utilisé pour encoder les noms d’entrée en octets.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. L’indicateur d’encodage linguistique (dans l’indicateur de bit à 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.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.

S’applique à