ZipArchive Konstruktory

Definice

Obor názvů:

System.IO.Compression

Sestavení:

System.IO.Compression.dll

Inicializuje novou instanci ZipArchive třídy .

Přetížení

ZipArchive(Stream)	Inicializuje novou instanci ZipArchive třídy ze zadaného datového proudu.
ZipArchive(Stream, ZipArchiveMode)	Inicializuje novou instanci ZipArchive třídy ze zadaného datového proudu a v zadaném režimu.
ZipArchive(Stream, ZipArchiveMode, Boolean)	Inicializuje novou instanci ZipArchive třídy v zadaném datovém proudu pro zadaný režim a volitelně ponechá datový proud otevřený.
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)	Inicializuje novou instanci ZipArchive třídy v zadaném datovém proudu pro zadaný režim, použije zadané kódování pro názvy položek a volitelně ponechá datový proud otevřený.

ZipArchive(Stream)

Zdroj:

ZipArchive.cs

Inicializuje novou instanci ZipArchive třídy ze zadaného datového proudu.

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)

Parametry

stream

Stream

Datový proud, který obsahuje archiv, který se má přečíst.

Výjimky

ArgumentException

Datový proud je již uzavřen nebo nepodporuje čtení.

ArgumentNullException

stream je null.

InvalidDataException

Obsah streamu není ve formátu archivu zip.

ZipArchive(Stream, ZipArchiveMode)

Zdroj:

ZipArchive.cs

Inicializuje novou instanci ZipArchive třídy ze zadaného datového proudu a v zadaném režimu.

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)

Parametry

stream

Stream

Vstupní nebo výstupní datový proud

mode

ZipArchiveMode

Jedna z hodnot výčtu, která označuje, zda se archiv ZIP používá ke čtení, vytváření nebo aktualizaci položek.

Výjimky

ArgumentException

Datový proud je již zavřený nebo možnosti datového proudu neodpovídají režimu.

ArgumentNullException

stream je null.

ArgumentOutOfRangeException

mode je neplatná hodnota.

InvalidDataException

Obsah datového proudu nelze interpretovat jako archiv zip.

-nebo-

mode je Update a položka chybí v archivu nebo je poškozena a nelze ji přečíst.

-nebo-

mode je Update a položka je příliš velká, aby se nevešla do paměti.

Poznámky

mode Pokud je parametr nastavený na Read, stream musí podporovat čtení. mode Pokud je parametr nastavený na Create, stream musí podporovat zápis. mode Pokud je parametr nastavený na Update, stream musí podporovat čtení, zápis a vyhledávání.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Zdroj:

ZipArchive.cs

Inicializuje novou instanci ZipArchive třídy v zadaném datovém proudu pro zadaný režim a volitelně ponechá datový proud otevřený.

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)

Parametry

stream

Stream

Vstupní nebo výstupní datový proud

mode

ZipArchiveMode

Jedna z hodnot výčtu, která označuje, zda se archiv ZIP používá ke čtení, vytváření nebo aktualizaci položek.

leaveOpen

Boolean

true , aby se datový proud po odstranění objektu ZipArchive nechal otevřený. V opačném případě false.

Výjimky

ArgumentException

Datový proud je již zavřený nebo možnosti datového proudu neodpovídají režimu.

ArgumentNullException

stream je null.

ArgumentOutOfRangeException

mode je neplatná hodnota.

InvalidDataException

Obsah datového proudu nelze interpretovat jako archiv zip.

-nebo-

mode je Update a položka chybí v archivu nebo je poškozena a nelze ji přečíst.

-nebo-

mode je Update a položka je příliš velká, aby se nevešla do paměti.

Poznámky

mode Pokud je parametr nastavený na Read, stream musí podporovat čtení. mode Pokud je parametr nastavený na Create, stream musí podporovat zápis. mode Pokud je parametr nastavený na Update, stream musí podporovat čtení, zápis a vyhledávání.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Zdroj:

ZipArchive.cs

Inicializuje novou instanci ZipArchive třídy v zadaném datovém proudu pro zadaný režim, použije zadané kódování pro názvy položek a volitelně ponechá datový proud otevřený.

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)

Parametry

stream

Stream

Vstupní nebo výstupní datový proud

mode

ZipArchiveMode

Jedna z hodnot výčtu, která označuje, zda se archiv ZIP používá ke čtení, vytváření nebo aktualizaci položek.

leaveOpen

Boolean

true , aby se datový proud po odstranění objektu ZipArchive nechal otevřený. V opačném případě false.

entryNameEncoding

Encoding

Kódování, které se má použít při čtení nebo zápisu názvů položek v tomto archivu. Hodnotu tohoto parametru zadejte pouze v případě, že je kódování vyžadováno pro interoperabilitu s archivačními nástroji a knihovnami zip, které nepodporují kódování UTF-8 pro názvy položek.

Výjimky

ArgumentException

Datový proud je již zavřený nebo možnosti datového proudu neodpovídají režimu.

-nebo-

Pro je zadáno entryNameEncodingkódování jiné než UTF-8.

ArgumentNullException

stream je null.

ArgumentOutOfRangeException

mode je neplatná hodnota.

InvalidDataException

Obsah datového proudu nelze interpretovat jako archiv zip.

-nebo-

mode je Update a položka chybí v archivu nebo je poškozena a nelze ji přečíst.

-nebo-

mode je Update a položka je příliš velká, aby se nevešla do paměti.

Poznámky

mode Pokud je parametr nastavený na Read, stream musí podporovat čtení. mode Pokud je parametr nastavený na Create, stream musí podporovat zápis. mode Pokud je parametr nastavený na Update, stream musí podporovat čtení, zápis a vyhledávání.

Když otevřete soubor archivu ZIP pro čtení a entryNameEncoding je nastaven na null, názvy položek jsou dekódovány podle následujících pravidel:

• Pokud není nastaven příznak kódování jazyka (v bitovém příznaku místního souboru pro obecné účely), použije se k dekódování názvu položky aktuální výchozí znaková stránka systému.

• Při nastavení příznaku kódování jazyka se k dekódování názvu položky použije UTF-8.

Když otevřete soubor zip archivu pro čtení a entryNameEncoding je nastavena na jinou hodnotu než null, názvy položek jsou dekódovány podle následujících pravidel:

• Pokud není nastaven příznak kódování jazyka, použije se k dekódování názvu položky zadaný entryNameEncoding znak .

• Při nastavení příznaku kódování jazyka se k dekódování názvu položky použije UTF-8.

Když zapisujete do archivačních souborů a entryNameEncoding je nastavená na null, názvy položek se kódují podle následujících pravidel:

• Pro názvy položek, které obsahují znaky mimo rozsah ASCII, je nastaven příznak kódování jazyka a názvy položek jsou kódovány pomocí UTF-8.

• U názvů položek, které obsahují pouze znaky ASCII, není nastaven příznak kódování jazyka a názvy položek jsou kódovány pomocí aktuální výchozí znakové stránky systému.

Když zapisujete do archivačních souborů a entryNameEncoding je nastavená na jinou hodnotu než null, použije se zadaná entryNameEncoding hodnota ke kódování názvů položek do bajtů. Příznak kódování jazyka (v bitovém příznaku místního souboru pro obecné účely) je nastaven pouze v případech, kdy je zadané kódování kódování UTF-8.