ZipArchive Konstruktorok

Definíció

Névtér:

System.IO.Compression

Szerelvény:

System.IO.Compression.dll

Inicializálja a ZipArchive osztály új példányát.

Túlterhelések

Name	Description
ZipArchive(Stream)	Inicializálja az ZipArchive osztály új példányát a megadott streamből.
ZipArchive(Stream, ZipArchiveMode)	Inicializálja az osztály új példányát a ZipArchive megadott streamből és a megadott móddal.
ZipArchive(Stream, ZipArchiveMode, Boolean)	Inicializálja az osztály új példányát a ZipArchive megadott streamen a megadott módhoz, és opcionálisan nyitva hagyja a streamet.
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)	Inicializálja az osztály új példányát a ZipArchive megadott streamben a megadott módhoz, a megadott kódolást használja a bejegyzésnevekhez, és opcionálisan nyitva hagyja a streamet.

ZipArchive(Stream)

Inicializálja az ZipArchive osztály új példányát a megadott streamből.

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)

Paraméterek

stream

Stream

Az olvasni kívánt archívumot tartalmazó stream.

Kivételek

ArgumentException

A stream már bezárult, vagy nem támogatja az olvasást.

ArgumentNullException

stream az null.

InvalidDataException

A stream tartalma nem zip-archívum formátumban van.

ZipArchive(Stream, ZipArchiveMode)

Inicializálja az osztály új példányát a ZipArchive megadott streamből és a megadott móddal.

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)

Paraméterek

stream

Stream

A bemeneti vagy kimeneti adatfolyam.

mode

ZipArchiveMode

Az egyik számbavételi érték, amely azt jelzi, hogy a zip-archívum a bejegyzések olvasására, létrehozására vagy frissítésére szolgál-e.

Kivételek

ArgumentException

A stream már bezárult, vagy a stream képességei nem felelnek meg a módnak.

ArgumentNullException

stream az null.

ArgumentOutOfRangeException

mode érvénytelen érték.

InvalidDataException

A stream tartalma nem értelmezhető zip-archívumként.

-vagy-

mode hiányzik Update egy bejegyzés az archívumból, vagy sérült, és nem olvasható.

-vagy-

mode van, Update és egy bejegyzés túl nagy ahhoz, hogy elférjen a memóriában.

Megjegyzések

Ha a mode paraméter be van állítva Read, a streamnek támogatnia kell az olvasást. Ha a mode paraméter be van állítva Create, a streamnek támogatnia kell az írást. Ha a mode paraméter be van állítva Update, a streamnek támogatnia kell az olvasást, az írást és a keresést.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Inicializálja az osztály új példányát a ZipArchive megadott streamen a megadott módhoz, és opcionálisan nyitva hagyja a streamet.

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)

Paraméterek

stream

Stream

A bemeneti vagy kimeneti adatfolyam.

mode

ZipArchiveMode

Az egyik számbavételi érték, amely azt jelzi, hogy a zip-archívum a bejegyzések olvasására, létrehozására vagy frissítésére szolgál-e.

leaveOpen

Boolean

true az objektum megsemmisítése után hagyja nyitva a ZipArchive streamet; falseellenkező esetben.

Kivételek

ArgumentException

A stream már bezárult, vagy a stream képességei nem felelnek meg a módnak.

ArgumentNullException

stream az null.

ArgumentOutOfRangeException

mode érvénytelen érték.

InvalidDataException

A stream tartalma nem értelmezhető zip-archívumként.

-vagy-

mode hiányzik Update egy bejegyzés az archívumból, vagy sérült, és nem olvasható.

-vagy-

mode van, Update és egy bejegyzés túl nagy ahhoz, hogy elférjen a memóriában.

Megjegyzések

Ha a mode paraméter be van állítva Read, a streamnek támogatnia kell az olvasást. Ha a mode paraméter be van állítva Create, a streamnek támogatnia kell az írást. Ha a mode paraméter be van állítva Update, a streamnek támogatnia kell az olvasást, az írást és a keresést.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Inicializálja az osztály új példányát a ZipArchive megadott streamben a megadott módhoz, a megadott kódolást használja a bejegyzésnevekhez, és opcionálisan nyitva hagyja a streamet.

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)

Paraméterek

stream

Stream

A bemeneti vagy kimeneti adatfolyam.

mode

ZipArchiveMode

Az egyik számbavételi érték, amely azt jelzi, hogy a zip-archívum a bejegyzések olvasására, létrehozására vagy frissítésére szolgál-e.

leaveOpen

Boolean

true az objektum megsemmisítése után hagyja nyitva a ZipArchive streamet; falseellenkező esetben.

entryNameEncoding

Encoding

Az archívumban lévő bejegyzésnevek és megjegyzések olvasásához vagy írásához használandó kódolás. Csak akkor adjon meg értéket ehhez a paraméterhez, ha kódolásra van szükség a bejegyzésnevek és megjegyzések UTF-8 kódolását nem támogató zip archív eszközökkel és kódtárakkal való együttműködéshez.

Kivételek

ArgumentException

A stream már bezárult, vagy a stream képességei nem felelnek meg a módnak.

-vagy-

Az UTF-8-tól eltérő kódolás van megadva a entryNameEncoding.

ArgumentNullException

stream az null.

ArgumentOutOfRangeException

mode érvénytelen érték.

InvalidDataException

A stream tartalma nem értelmezhető zip-archívumként.

-vagy-

mode hiányzik Update egy bejegyzés az archívumból, vagy sérült, és nem olvasható.

-vagy-

mode van, Update és egy bejegyzés túl nagy ahhoz, hogy elférjen a memóriában.

Megjegyzések

Ha a mode paraméter be van állítva Read, a streamnek támogatnia kell az olvasást. Ha a mode paraméter be van állítva Create, a streamnek támogatnia kell az írást. Ha a mode paraméter be van állítva Update, a streamnek támogatnia kell az olvasást, az írást és a keresést.

Amikor megnyit egy zip-archívumfájlt olvasásra, és entryNameEncoding be van állítva null, a bejegyzésnevek és a megjegyzések a következő szabályok szerint lesznek dekódolva:

• Ha a nyelvi kódolás jelzője (a helyi fájlfejléc általános célú bitjelölőjében) nincs beállítva, a rendszer az aktuális rendszer alapértelmezett kódlapját használja a bejegyzés nevének és megjegyzésének dekódolásához.
• A nyelvi kódolási jelző beállításakor az UTF-8 a bejegyzés nevének és megjegyzésének dekódolására szolgál.

Amikor megnyit egy zip-archívumfájlt olvasásra, és entryNameEncoding nem a következő értékre nullvan beállítva, a bejegyzésneveket és a megjegyzéseket a rendszer az alábbi szabályok szerint dekódolja:

• Ha a nyelvi kódolási jelző nincs beállítva, a megadott entryNameEncoding érték a bejegyzés nevének és megjegyzésének dekódolására szolgál.
• A nyelvi kódolási jelző beállításakor az UTF-8 a bejegyzés nevének és megjegyzésének dekódolására szolgál.

Ha archivált fájlokba ír, és entryNameEncoding a beállítás értéke nulla következő szabályok szerint van beállítva, a bejegyzésnevek és a megjegyzések kódolása a következő szabályok szerint történik:

• Az ASCII-tartományon kívüli karaktereket tartalmazó bejegyzésnevekhez és megjegyzésekhez be van állítva a nyelvkódoló jelző, a bejegyzésnevek és megjegyzések pedig az UTF-8 használatával vannak kódolva.
• A csak ASCII-karaktereket tartalmazó bejegyzésnevek és megjegyzések esetében nincs beállítva a nyelvkódoló jelző, a bejegyzésneveket és a megjegyzéseket pedig az aktuális rendszer alapértelmezett kódlapja kódolja.

Ha archivált fájlokat ír, és entryNameEncoding nem egy értékre nullvan beállítva, a megadott entryNameEncoding érték a bejegyzésneveket és a megjegyzéseket bájtokra kódolja. A nyelvi kódolás jelzője (a helyi fájlfejléc általános célú bitjelölőjében) csak akkor van beállítva, ha a megadott kódolás UTF-8 kódolás.