ZipArchive Konstruktory

Definice

Obor názvů:

System.IO.Compression

Sestavení:

netstandard.dll, System.IO.Compression.dll

Inicializuje novou instanci ZipArchive třídy.

Přetížení

Name	Description
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 se zadaným režimem.
ZipArchive(Stream, ZipArchiveMode, Boolean)	Inicializuje novou instanci ZipArchive třídy v zadaném datovém proudu pro zadaný režim a volitelně ponechá stream 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á stream 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

Stream je již zavřený nebo nepodporuje čtení.

ArgumentNullException

stream je null.

InvalidDataException

Obsah datového proudu není ve formátu zip archivu.

ZipArchive(Stream, ZipArchiveMode)

Zdroj:

ZipArchive.cs

Inicializuje novou instanci ZipArchive třídy ze zadaného datového proudu a se zadaným režimem.

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

Stream 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 vešla do paměti.

Poznámky

mode Pokud je parametr nastavený na Read, datový proud musí podporovat čtení. mode Pokud je parametr nastavený na Create, datový proud musí podporovat zápis. mode Pokud je parametr nastavený na Update, datový proud musí podporovat čtení, zápis a hledá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á stream 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

truenechat datový proud otevřený po odstranění objektuZipArchive; v opačném případě . false

Výjimky

ArgumentException

Stream 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 vešla do paměti.

Poznámky

mode Pokud je parametr nastavený na Read, datový proud musí podporovat čtení. mode Pokud je parametr nastavený na Create, datový proud musí podporovat zápis. mode Pokud je parametr nastavený na Update, datový proud musí podporovat čtení, zápis a hledá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á stream 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

truenechat datový proud otevřený po odstranění objektuZipArchive; 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 a komentářů v tomto archivu. Zadejte hodnotu pro tento parametr pouze v případě, že je vyžadováno kódování pro interoperabilitu s nástroji a knihovnami zip archivu, které nepodporují kódování UTF-8 pro názvy položek nebo komentáře.

Výjimky

ArgumentException

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

nebo

Kódování jiné než UTF-8 je určeno pro entryNameEncoding.

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 vešla do paměti.

Poznámky

mode Pokud je parametr nastavený na Read, datový proud musí podporovat čtení. mode Pokud je parametr nastavený na Create, datový proud musí podporovat zápis. mode Pokud je parametr nastavený na Update, datový proud musí podporovat čtení, zápis a hledání.

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

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

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

• Pokud není nastaven příznak kódování jazyka, zadaná entryNameEncoding hodnota se použije k dekódování názvu položky a komentáře.
• Pokud je nastaven příznak kódování jazyka, UTF-8 slouží k dekódování názvu položky a komentáře.

Při zápisu do archivu souborů a entryNameEncoding je nastavena na null, názvy položek a komentáře jsou kódovány podle následujících pravidel:

• Pro názvy položek a komentáře, které obsahují znaky mimo rozsah ASCII, je nastaven příznak kódování jazyka a názvy položek a komentáře jsou kódovány pomocí UTF-8.
• Pro názvy položek a komentáře, které obsahují pouze znaky ASCII, není nastaven příznak kódování jazyka a názvy položek a komentáře jsou kódovány pomocí aktuální výchozí znakové stránky systému.

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