ZipArchive Konstruktory

Definice

Inicializuje novou instanci třídy ZipArchive třídy.Initializes a new instance of the ZipArchive class.

Přetížení

ZipArchive(Stream)

Inicializuje novou instanci třídy ZipArchive ze zadaného datového proudu.Initializes a new instance of the ZipArchive class from the specified stream.

ZipArchive(Stream, ZipArchiveMode)

Inicializuje novou instanci třídy ZipArchive ze zadaného datového proudu a se zadaným režimem.Initializes a new instance of the ZipArchive class from the specified stream and with the specified mode.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Inicializuje novou instanci třídy ZipArchive v zadaném datovém proudu pro zadaný režim a volitelně ponechá datový proud otevřený.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)

Inicializuje novou instanci třídy ZipArchive v zadaném datovém proudu pro zadaný režim, používá zadané kódování pro názvy záznamů a volitelně ponechá datový proud otevřený.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)

Inicializuje novou instanci třídy ZipArchive ze zadaného datového proudu.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

Parametry

stream
Stream

Datový proud obsahující archiv, který má být načten.The stream that contains the archive to be read.

Výjimky

Stream je už uzavřený nebo nepodporuje čtení.The stream is already closed or does not support reading.

stream je null.stream is null.

Obsah datového proudu není ve formátu archivu zip.The contents of the stream are not in the zip archive format.

ZipArchive(Stream, ZipArchiveMode)

Inicializuje novou instanci třídy ZipArchive ze zadaného datového proudu a se zadaným režimem.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

Parametry

stream
Stream

Vstupní nebo výstupní datový proudThe input or output stream.

mode
ZipArchiveMode

Jedna z hodnot výčtu, která určuje, zda se archiv zip používá ke čtení, vytvoření nebo aktualizaci položek.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

Výjimky

Stream je už uzavřený, nebo se možnosti streamu neshodují s režimem.The stream is already closed, or the capabilities of the stream do not match the mode.

stream je null.stream is null.

mode je neplatná hodnota.mode is an invalid value.

Obsah datového proudu nelze interpretovat jako archiv zip.The contents of the stream could not be interpreted as a zip archive.

-nebo--or- mode je Update a položka chybí v archivu nebo je poškozená a nedá se přečíst.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

-nebo--or- mode je Update a položka je příliš velká, aby se vešla do paměti.mode is Update and an entry is too large to fit into memory.

Poznámky

Pokud je parametr mode nastaven na Read, datový proud musí podporovat čtení.If the mode parameter is set to Read, the stream must support reading. Pokud je parametr mode nastaven na Create, datový proud musí podporovat zápis.If the mode parameter is set to Create, the stream must support writing. Pokud je parametr mode nastaven na hodnotu Update, datový proud musí podporovat čtení, zápis a hledání.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Inicializuje novou instanci třídy ZipArchive v zadaném datovém proudu pro zadaný režim a volitelně ponechá datový proud otevřený.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

Parametry

stream
Stream

Vstupní nebo výstupní datový proudThe input or output stream.

mode
ZipArchiveMode

Jedna z hodnot výčtu, která určuje, zda se archiv zip používá ke čtení, vytvoření nebo aktualizaci položek.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

leaveOpen
Boolean

true ponechat datový proud otevřený po vyřazení ZipArchive objektu; v opačném případě false.true to leave the stream open after the ZipArchive object is disposed; otherwise, false.

Výjimky

Stream je už uzavřený, nebo se možnosti streamu neshodují s režimem.The stream is already closed, or the capabilities of the stream do not match the mode.

stream je null.stream is null.

mode je neplatná hodnota.mode is an invalid value.

Obsah datového proudu nelze interpretovat jako archiv zip.The contents of the stream could not be interpreted as a zip archive.

-nebo--or- mode je Update a položka chybí v archivu nebo je poškozená a nedá se přečíst.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

-nebo--or- mode je Update a položka je příliš velká, aby se vešla do paměti.mode is Update and an entry is too large to fit into memory.

Poznámky

Pokud je parametr mode nastaven na Read, datový proud musí podporovat čtení.If the mode parameter is set to Read, the stream must support reading. Pokud je parametr mode nastaven na Create, datový proud musí podporovat zápis.If the mode parameter is set to Create, the stream must support writing. Pokud je parametr mode nastaven na hodnotu Update, datový proud musí podporovat čtení, zápis a hledání.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Inicializuje novou instanci třídy ZipArchive v zadaném datovém proudu pro zadaný režim, používá zadané kódování pro názvy záznamů a volitelně ponechá datový proud otevřený.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

Parametry

stream
Stream

Vstupní nebo výstupní datový proudThe input or output stream.

mode
ZipArchiveMode

Jedna z hodnot výčtu, která určuje, zda se archiv zip používá ke čtení, vytvoření nebo aktualizaci položek.One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

leaveOpen
Boolean

true ponechat datový proud otevřený po vyřazení ZipArchive objektu; v opačném případě false.true to leave the stream open after the ZipArchive object is disposed; otherwise, false.

entryNameEncoding
Encoding

Kódování, které má být použito při čtení nebo zápisu názvů položek v tomto archivu.The encoding to use when reading or writing entry names in this archive. Zadejte hodnotu pro tento parametr pouze v případě, že je vyžadováno kódování pro interoperabilitu s nástroji a knihovnami archivu zip, které pro vstupní názvy nepodporují kódování UTF-8.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.

Výjimky

Stream je už uzavřený, nebo se možnosti streamu neshodují s režimem.The stream is already closed, or the capabilities of the stream do not match the mode.

stream je null.stream is null.

mode je neplatná hodnota.mode is an invalid value.

Obsah datového proudu nelze interpretovat jako archiv zip.The contents of the stream could not be interpreted as a zip archive.

-nebo--or- mode je Update a položka chybí v archivu nebo je poškozená a nedá se přečíst.mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

-nebo--or- mode je Update a položka je příliš velká, aby se vešla do paměti.mode is Update and an entry is too large to fit into memory.

Poznámky

Pokud je parametr mode nastaven na Read, datový proud musí podporovat čtení.If the mode parameter is set to Read, the stream must support reading. Pokud je parametr mode nastaven na Create, datový proud musí podporovat zápis.If the mode parameter is set to Create, the stream must support writing. Pokud je parametr mode nastaven na hodnotu Update, datový proud musí podporovat čtení, zápis a hledání.If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

Když otevřete soubor archivu zip pro čtení a entryNameEncoding je nastavené na null, názvy položek se dekóduje podle následujících pravidel:When you open a zip archive file for reading and entryNameEncoding is set to null, entry names are decoded according to the following rules:

  • Pokud není nastaven příznak kódování jazyka (v poli příznak bitového pro obecné použití v hlavičce místního souboru), použije se k dekódování názvu položky aktuální výchozí systémová znaková stránka.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.

  • Pokud je nastaven příznak kódování jazyka, použije se k dekódování názvu položky znak UTF-8.When the language encoding flag is set, UTF-8 is used to decode the entry name.

Když otevřete soubor archivu zip pro čtení a entryNameEncoding je nastavená na jinou hodnotu než null, názvy položek se dekóduje podle následujících pravidel: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:

  • Pokud není nastaven příznak kódování jazyka, je k dekódování názvu položky použit zadaný entryNameEncoding.When the language encoding flag is not set, the specified entryNameEncoding is used to decode the entry name.

  • Pokud je nastaven příznak kódování jazyka, použije se k dekódování názvu položky znak UTF-8.When the language encoding flag is set, UTF-8 is used to decode the entry name.

Když zapisujete do souborů archivu a entryNameEncoding je nastavená na null, názvy položek se zakódují podle následujících pravidel:When you write to archive files and entryNameEncoding is set to null, entry names are encoded according to the following rules:

  • U názvů zadání, které obsahují znaky mimo rozsah ASCII, je nastaven příznak kódování jazyka a vstupní názvy jsou kódovány pomocí kódování 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.

  • U názvů zadání, které obsahují pouze znaky ASCII, není nastaven příznak kódování jazyka a názvy záznamů jsou zakódovány pomocí výchozí systémové znakové stránky.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.

Když zapisujete do souborů archivu a entryNameEncoding je nastavená na jinou hodnotu než null, zadaný entryNameEncoding se použije ke kódování názvů položek do bajtů.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. Příznak kódování jazyka (v případě bitového příznaku pro obecné účely v hlavičce místního souboru) je nastaven pouze v případě, že zadané kódování je kódování 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.

Platí pro