ZipArchive Konstruktory

Definicja

Przestrzeń nazw:

System.IO.Compression

Zestawy:

netstandard.dll, System.IO.Compression.dll

Inicjuje nowe wystąpienie klasy ZipArchive.

Przeciążenia

Nazwa	Opis
ZipArchive(Stream)	Inicjuje nowe wystąpienie ZipArchive klasy z określonego strumienia.
ZipArchive(Stream, ZipArchiveMode)	Inicjuje nowe wystąpienie ZipArchive klasy z określonego strumienia i przy użyciu określonego trybu.
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 dla nazw wpisów i opcjonalnie pozostawia otwarty strumień.

ZipArchive(Stream)

Źródło:

ZipArchive.cs

Inicjuje nowe wystąpienie ZipArchive 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

Parametr stream ma wartość null.

InvalidDataException

Zawartość strumienia nie jest w formacie archiwum zip.

ZipArchive(Stream, ZipArchiveMode)

Źródło:

ZipArchive.cs

Inicjuje nowe wystąpienie ZipArchive klasy z określonego strumienia i przy użyciu określonego trybu.

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

Parametr stream ma wartość null.

ArgumentOutOfRangeException

mode jest nieprawidłową wartością.

InvalidDataException

Nie można zinterpretować 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 jest ustawiony na Readwartość , strumień musi obsługiwać odczyt. mode Jeśli parametr jest ustawiony na Createwartość , 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

Parametr stream ma wartość null.

ArgumentOutOfRangeException

mode jest nieprawidłową wartością.

InvalidDataException

Nie można zinterpretować 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 jest ustawiony na Readwartość , strumień musi obsługiwać odczyt. mode Jeśli parametr jest ustawiony na Createwartość , 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 dla 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 używane podczas odczytywania lub zapisywania nazw wpisów i komentarzy w tym archiwum. Określ wartość dla 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 lub komentarzy.

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

Parametr stream ma wartość null.

ArgumentOutOfRangeException

mode jest nieprawidłową wartością.

InvalidDataException

Nie można zinterpretować 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 jest ustawiony na Readwartość , strumień musi obsługiwać odczyt. mode Jeśli parametr jest ustawiony na Createwartość , 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 jest ustawiony na null, nazwy wpisów i komentarze 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 i komentarza.
• Po ustawieniu flagi kodowania języka kodowanie UTF-8 służy do dekodowania nazwy wpisu i komentarza.

Po otwarciu pliku archiwum zip do odczytu i entryNameEncoding jest ustawiona na wartość inną niż null, nazwy i komentarze 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 i komentarza.
• Po ustawieniu flagi kodowania języka kodowanie UTF-8 służy do dekodowania nazwy wpisu i komentarza.

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

• W przypadku nazw wpisów i komentarzy, które zawierają znaki poza zakresem ASCII, ustawiono flagę kodowania języka, a nazwy wpisów i komentarze są kodowane przy użyciu protokołu UTF-8.
• W przypadku nazw wpisów i komentarzy zawierających tylko znaki ASCII flaga kodowania języka nie jest ustawiona, a nazwy i komentarze wpisu są kodowane przy użyciu bieżącej domyślnej strony kodowej systemu.

Podczas zapisywania w plikach archiwalnych i entryNameEncoding ustawiono wartość inną niż null, określona entryNameEncoding wartość jest używana do kodowania nazw wpisów i komentarzy 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.