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
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
- Source:
- ZipArchive.cs
- 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
Le flux ne prend pas en charge l’écriture ou bien il est déjà fermé.
stream
a la valeur null
.
Le contenu du flux de données n’est pas au format d’archivage ZIP.
S’applique à
ZipArchive(Stream, ZipArchiveMode)
- Source:
- ZipArchive.cs
- Source:
- ZipArchive.cs
- 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
Le flux de données est déjà fermé, ou les fonctions du flux de données ne correspondent pas au mode.
stream
a la valeur null
.
mode
n’est pas une valeur valide.
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.
S’applique à
ZipArchive(Stream, ZipArchiveMode, Boolean)
- Source:
- ZipArchive.cs
- Source:
- ZipArchive.cs
- 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
Le flux de données est déjà fermé, ou les fonctions du flux de données ne correspondent pas au mode.
stream
a la valeur null
.
mode
n’est pas une valeur valide.
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.
S’applique à
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)
- Source:
- ZipArchive.cs
- Source:
- ZipArchive.cs
- 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);
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
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
.
stream
a la valeur null
.
mode
n’est pas une valeur valide.
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.