ZipArchive Konstruktoren

Definition

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Initialisiert eine neue Instanz der ZipArchive-Klasse.

Überlädt

ZipArchive(Stream)	Initialisiert eine neue Instanz der ZipArchive-Klasse aus dem angegebenen Stream.
ZipArchive(Stream, ZipArchiveMode)	Initialisiert eine neue Instanz der ZipArchive-Klasse aus dem angegebenen Stream und mit dem angegebenen Modus.
ZipArchive(Stream, ZipArchiveMode, Boolean)	Initialisiert eine neue Instanz der ZipArchive-Klasse für den angegebenen Stream und den angegebenen Modus und lässt den Stream optional geöffnet.
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)	Initialisiert eine neue Instanz der ZipArchive-Klasse für den angegebenen Stream und den angegebenen Modus und verwendet dabei die angegebene Codierung für Eintragsnamen und lässt den Stream optional geöffnet.

ZipArchive(Stream)

Quelle:

ZipArchive.cs

Initialisiert eine neue Instanz der ZipArchive-Klasse aus dem angegebenen Stream.

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)

Parameter

stream

Stream

Ein Stream, der das zu lesende Archiv enthält.

Ausnahmen

ArgumentException

Der Stream wurde bereits geschlossen oder unterstützt keine Lesevorgänge.

ArgumentNullException

stream ist null.

InvalidDataException

Die Inhalte des Streams haben nicht das ZIP-Archivformat.

ZipArchive(Stream, ZipArchiveMode)

Quelle:

ZipArchive.cs

Initialisiert eine neue Instanz der ZipArchive-Klasse aus dem angegebenen Stream und mit dem angegebenen Modus.

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)

Parameter

stream

Stream

Der Eingabe- oder Ausgabestream.

mode

ZipArchiveMode

Einer der Enumerationswerte, der angibt, ob das Zip-Archiv verwendet wird, um Einträge zu lesen, zu erstellen oder zu aktualisieren.

Ausnahmen

ArgumentException

Der Stream ist bereits geschlossen oder die Funktionen des Streams stimmen nicht mit dem Modus überein.

ArgumentNullException

stream ist null.

ArgumentOutOfRangeException

mode ist ein ungültiger Wert.

InvalidDataException

Die Inhalte des Streams konnten nicht als ZIP-Archiv interpretiert werden.

- oder -

mode ist Update und ein Eintrag im Archiv fehlt oder ist beschädigt und kann nicht gelesen werden.

- oder -

mode ist Update und ein Eintrag ist zu groß, um in den Arbeitsspeicher zu passen.

Hinweise

Wenn der mode Parameter auf Readfestgelegt ist, muss der Stream das Lesen unterstützen. Wenn der mode Parameter auf Createfestgelegt ist, muss der Stream das Schreiben unterstützen. Wenn der mode Parameter auf Updatefestgelegt ist, muss der Stream das Lesen, Schreiben und Suchen unterstützen.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Quelle:

ZipArchive.cs

Initialisiert eine neue Instanz der ZipArchive-Klasse für den angegebenen Stream und den angegebenen Modus und lässt den Stream optional geöffnet.

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)

Parameter

stream

Stream

Der Eingabe- oder Ausgabestream.

mode

ZipArchiveMode

Einer der Enumerationswerte, der angibt, ob das Zip-Archiv verwendet wird, um Einträge zu lesen, zu erstellen oder zu aktualisieren.

leaveOpen

Boolean

true, um den Datenstrom geöffnet zu lassen, nach dem das ZipArchive-Objekt freigegeben wurde; andernfalls false.

Ausnahmen

ArgumentException

Der Stream ist bereits geschlossen oder die Funktionen des Streams stimmen nicht mit dem Modus überein.

ArgumentNullException

stream ist null.

ArgumentOutOfRangeException

mode ist ein ungültiger Wert.

InvalidDataException

Die Inhalte des Streams konnten nicht als ZIP-Archiv interpretiert werden.

- oder -

mode ist Update und ein Eintrag im Archiv fehlt oder ist beschädigt und kann nicht gelesen werden.

- oder -

mode ist Update und ein Eintrag ist zu groß, um in den Arbeitsspeicher zu passen.

Hinweise

Wenn der mode Parameter auf Readfestgelegt ist, muss der Stream das Lesen unterstützen. Wenn der mode Parameter auf Createfestgelegt ist, muss der Stream das Schreiben unterstützen. Wenn der mode Parameter auf Updatefestgelegt ist, muss der Stream das Lesen, Schreiben und Suchen unterstützen.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Quelle:

ZipArchive.cs

Initialisiert eine neue Instanz der ZipArchive-Klasse für den angegebenen Stream und den angegebenen Modus und verwendet dabei die angegebene Codierung für Eintragsnamen und lässt den Stream optional geöffnet.

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)

Parameter

stream

Stream

Der Eingabe- oder Ausgabestream.

mode

ZipArchiveMode

Einer der Enumerationswerte, der angibt, ob das Zip-Archiv verwendet wird, um Einträge zu lesen, zu erstellen oder zu aktualisieren.

leaveOpen

Boolean

true, um den Datenstrom geöffnet zu lassen, nach dem das ZipArchive-Objekt freigegeben wurde; andernfalls false.

entryNameEncoding

Encoding

Die Codierung, die beim Lesen oder Schreiben von Eintragsnamen in diesem Archiv verwendet werden soll. Geben Sie einen Wert für diesen Parameter nur an, wenn eine Codierung für die Interoperabilität mit ZIP-Archiv-Tools und -Bibliotheken erforderlich ist, die die UTF-8-Codierung für Eintragsnamen nicht unterstützen.

Ausnahmen

ArgumentException

Der Stream ist bereits geschlossen oder die Funktionen des Streams stimmen nicht mit dem Modus überein.

- oder -

Für entryNameEncoding wird eine andere Codierung als UTF-8 angegeben.

ArgumentNullException

stream ist null.

ArgumentOutOfRangeException

mode ist ein ungültiger Wert.

InvalidDataException

Die Inhalte des Streams konnten nicht als ZIP-Archiv interpretiert werden.

- oder -

mode ist Update und ein Eintrag im Archiv fehlt oder ist beschädigt und kann nicht gelesen werden.

- oder -

mode ist Update und ein Eintrag ist zu groß, um in den Arbeitsspeicher zu passen.

Hinweise

Wenn der mode Parameter auf Readfestgelegt ist, muss der Stream das Lesen unterstützen. Wenn der mode Parameter auf Createfestgelegt ist, muss der Stream das Schreiben unterstützen. Wenn der mode Parameter auf Updatefestgelegt ist, muss der Stream das Lesen, Schreiben und Suchen unterstützen.

Wenn Sie eine ZIP-Archivdatei zum Lesen öffnen und entryNameEncoding auf nullfestgelegt ist, werden Eintragsnamen gemäß den folgenden Regeln decodiert:

• Wenn das Sprachcodierungsflag (im universellen Bitflag des lokalen Dateiheaders) nicht festgelegt ist, wird die aktuelle Systemstandardcodepage verwendet, um den Eintragsnamen zu decodieren.

• Wenn das Sprachcodierungsflag festgelegt ist, wird UTF-8 verwendet, um den Eintragsnamen zu decodieren.

Wenn Sie eine ZIP-Archivdatei zum Lesen öffnen und entryNameEncoding auf einen anderen Wert als nullfestgelegt ist, werden Eintragsnamen gemäß den folgenden Regeln decodiert:

• Wenn das Sprachcodierungsflag nicht festgelegt ist, wird das angegebene entryNameEncoding verwendet, um den Eintragsnamen zu decodieren.

• Wenn das Sprachcodierungsflag festgelegt ist, wird UTF-8 verwendet, um den Eintragsnamen zu decodieren.

Wenn Sie in Archivdateien schreiben und entryNameEncoding auf nullfestgelegt sind, werden Eintragsnamen gemäß den folgenden Regeln codiert:

• Für Eintragsnamen, die Zeichen außerhalb des ASCII-Bereichs enthalten, ist das Sprachcodierungsflag festgelegt, und Die Eingabenamen werden mithilfe von UTF-8 codiert.

• Für Eintragsnamen, die nur ASCII-Zeichen enthalten, ist das Sprachcodierungsflag nicht festgelegt, und Eingabenamen werden mithilfe der aktuellen Systemstandardcodepage codiert.

Wenn Sie in Archivdateien schreiben und entryNameEncoding auf einen anderen Wert als nullfestgelegt ist, wird der angegebene entryNameEncoding verwendet, um die Eintragsnamen in Bytes zu codieren. Das Sprachcodierungsflag (im universellen Bitflag des lokalen Dateiheaders) wird nur festgelegt, wenn die angegebene Codierung eine UTF-8-Codierung ist.