Freigeben über


ZipArchive Konstruktoren

Definition

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
Quelle:
ZipArchive.cs
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

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

stream ist null.

Die Inhalte des Streams haben nicht das ZIP-Archivformat.

Gilt für:

ZipArchive(Stream, ZipArchiveMode)

Quelle:
ZipArchive.cs
Quelle:
ZipArchive.cs
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

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

stream ist null.

mode ist ein ungültiger Wert.

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.

Gilt für:

ZipArchive(Stream, ZipArchiveMode, Boolean)

Quelle:
ZipArchive.cs
Quelle:
ZipArchive.cs
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

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

stream ist null.

mode ist ein ungültiger Wert.

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.

Gilt für:

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Quelle:
ZipArchive.cs
Quelle:
ZipArchive.cs
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);
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

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.

stream ist null.

mode ist ein ungültiger Wert.

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 headers der lokalen Datei) nicht festgelegt ist, wird die aktuelle Standardcodepage des Systems 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 der angegebene entryNameEncoding zum Decodieren des Eintragsnamens verwendet.

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

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

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

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

Wenn Sie in Archivdateien schreiben und entryNameEncoding auf einen anderen Wert als nullfestgelegt sind, 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.

Gilt für: