ZipArchive Konstruktory

Definicja

Przestrzeń nazw:

System.IO.Compression

Zestaw:

System.IO.Compression.dll

Inicjuje nowe wystąpienie klasy ZipArchive.

Przeciążenia

ZipArchive(Stream)	Inicjuje ZipArchive nowe wystąpienie klasy z określonego strumienia.
ZipArchive(Stream, ZipArchiveMode)	Inicjuje ZipArchive nowe wystąpienie klasy z określonego strumienia i z określonym trybem.
ZipArchive(Stream, ZipArchiveMode, Boolean)	Inicjuje nowe wystąpienie ZipArchive klasy w określonym strumieniu dla określonego trybu i opcjonalnie pozostawia otwarty strumień.
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)	Inicjuje nowe wystąpienie ZipArchive klasy w określonym strumieniu dla określonego trybu, używa określonego kodowania nazw wpisów i opcjonalnie pozostawia otwarty strumień.

ZipArchive(Stream)

Źródło:

ZipArchive.cs

Inicjuje ZipArchive nowe wystąpienie klasy z określonego strumienia.

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

Strumień zawierający archiwum do odczytania.

Wyjątki

ArgumentException

Strumień jest już zamknięty lub nie obsługuje odczytu.

ArgumentNullException

stream to null.

InvalidDataException

Zawartość strumienia nie jest w formacie archiwum zip.

ZipArchive(Stream, ZipArchiveMode)

Źródło:

ZipArchive.cs

Inicjuje ZipArchive nowe wystąpienie klasy z określonego strumienia i z określonym trybem.

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

Strumień wejściowy lub wyjściowy.

mode

ZipArchiveMode

Jedna z wartości wyliczenia wskazująca, czy archiwum zip jest używane do odczytywania, tworzenia lub aktualizowania wpisów.

Wyjątki

ArgumentException

Strumień jest już zamknięty lub możliwości strumienia nie są zgodne z trybem.

ArgumentNullException

stream to null.

ArgumentOutOfRangeException

mode jest nieprawidłową wartością.

InvalidDataException

Nie można interpretować zawartości strumienia jako archiwum zip.

-lub-

mode jest Update i brakuje wpisu z archiwum lub jest uszkodzony i nie można go odczytać.

-lub-

mode jest Update i wpis jest zbyt duży, aby zmieścić się w pamięci.

Uwagi

mode Jeśli parametr ma wartość Read, strumień musi obsługiwać odczyt. mode Jeśli parametr ma wartość Create, strumień musi obsługiwać zapisywanie. mode Jeśli parametr ma wartość Update, strumień musi obsługiwać odczytywanie, zapisywanie i wyszukiwanie.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Źródło:

ZipArchive.cs

Inicjuje nowe wystąpienie ZipArchive klasy w określonym strumieniu dla określonego trybu i opcjonalnie pozostawia otwarty strumień.

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

Strumień wejściowy lub wyjściowy.

mode

ZipArchiveMode

Jedna z wartości wyliczenia wskazująca, czy archiwum zip jest używane do odczytywania, tworzenia lub aktualizowania wpisów.

leaveOpen

Boolean

true aby pozostawić strumień otwarty po usunięciu ZipArchive obiektu; w przeciwnym razie false.

Wyjątki

ArgumentException

Strumień jest już zamknięty lub możliwości strumienia nie są zgodne z trybem.

ArgumentNullException

stream to null.

ArgumentOutOfRangeException

mode jest nieprawidłową wartością.

InvalidDataException

Nie można interpretować zawartości strumienia jako archiwum zip.

-lub-

mode jest Update i brakuje wpisu z archiwum lub jest uszkodzony i nie można go odczytać.

-lub-

mode jest Update i wpis jest zbyt duży, aby zmieścić się w pamięci.

Uwagi

mode Jeśli parametr ma wartość Read, strumień musi obsługiwać odczyt. mode Jeśli parametr ma wartość Create, strumień musi obsługiwać zapisywanie. mode Jeśli parametr ma wartość Update, strumień musi obsługiwać odczytywanie, zapisywanie i wyszukiwanie.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Źródło:

ZipArchive.cs

Inicjuje nowe wystąpienie ZipArchive klasy w określonym strumieniu dla określonego trybu, używa określonego kodowania nazw wpisów i opcjonalnie pozostawia otwarty strumień.

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

Strumień wejściowy lub wyjściowy.

mode

ZipArchiveMode

Jedna z wartości wyliczenia wskazująca, czy archiwum zip jest używane do odczytywania, tworzenia lub aktualizowania wpisów.

leaveOpen

Boolean

true aby pozostawić strumień otwarty po usunięciu ZipArchive obiektu; w przeciwnym razie false.

entryNameEncoding

Encoding

Kodowanie do użycia podczas odczytywania lub zapisywania nazw wpisów w tym archiwum. Określ wartość tego parametru tylko wtedy, gdy kodowanie jest wymagane do współdziałania z narzędziami archiwum zip i bibliotekami, które nie obsługują kodowania UTF-8 dla nazw wpisów.

Wyjątki

ArgumentException

Strumień jest już zamknięty lub możliwości strumienia nie są zgodne z trybem.

-lub-

Dla parametru entryNameEncodingokreślono kodowanie inne niż UTF-8.

ArgumentNullException

stream to null.

ArgumentOutOfRangeException

mode jest nieprawidłową wartością.

InvalidDataException

Nie można interpretować zawartości strumienia jako archiwum zip.

-lub-

mode jest Update i brakuje wpisu z archiwum lub jest uszkodzony i nie można go odczytać.

-lub-

mode jest Update i wpis jest zbyt duży, aby zmieścić się w pamięci.

Uwagi

mode Jeśli parametr ma wartość Read, strumień musi obsługiwać odczyt. mode Jeśli parametr ma wartość Create, strumień musi obsługiwać zapisywanie. mode Jeśli parametr ma wartość Update, strumień musi obsługiwać odczytywanie, zapisywanie i wyszukiwanie.

Po otwarciu pliku archiwum zip do odczytu i entryNameEncoding ustawieniu na nullwartość , nazwy wpisów są dekodowane zgodnie z następującymi regułami:

• Gdy flaga kodowania języka (w flagi bitowej ogólnego przeznaczenia nagłówka pliku lokalnego) nie jest ustawiona, bieżąca domyślna strona kodowa systemu jest używana do dekodowania nazwy wpisu.

• Po ustawieniu flagi kodowania języka kodowanie UTF-8 służy do dekodowania nazwy wpisu.

Po otwarciu pliku archiwum zip do odczytu i entryNameEncoding jest ustawiona na wartość inną niż null, nazwy wpisów są dekodowane zgodnie z następującymi regułami:

• Gdy flaga kodowania języka nie jest ustawiona, określona entryNameEncoding jest używana do dekodowania nazwy wpisu.

• Po ustawieniu flagi kodowania języka kodowanie UTF-8 służy do dekodowania nazwy wpisu.

Podczas zapisywania w plikach archiwum i entryNameEncoding ustawiono na nullwartość , nazwy wpisów są kodowane zgodnie z następującymi regułami:

• W przypadku nazw wpisów zawierających znaki poza zakresem ASCII jest ustawiona flaga kodowania języka, a nazwy wpisów są kodowane przy użyciu protokołu UTF-8.

• W przypadku nazw wpisów zawierających tylko znaki ASCII flaga kodowania języka nie jest ustawiona, a nazwy wpisów są kodowane przy użyciu bieżącej domyślnej strony kodowej systemu.

Podczas zapisywania w plikach archiwum i entryNameEncoding ustawiana jest wartość inna niż null, określona entryNameEncoding jest używana do kodowania nazw wpisów do bajtów. Flaga kodowania języka (w flagi bitowej ogólnego przeznaczenia nagłówka pliku lokalnego) jest ustawiana tylko wtedy, gdy określone kodowanie jest kodowaniem UTF-8.