ZipArchive Konstruktoren

Definition

Namespace:: System.IO.Compression

Assembly:: System.IO.Compression.dll

Assemblys:: netstandard.dll, System.IO.Compression.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der ZipArchive-Klasse.

Überlädt

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

ZipArchive(Stream)

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Initialisiert eine neue Instanz der ZipArchive Klasse aus dem angegebenen Datenstrom.

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

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

Ausnahmen

ArgumentException

Der Datenstrom ist bereits geschlossen oder unterstützt das Lesen nicht.

ArgumentNullException

stream ist null.

InvalidDataException

Der Inhalt des Datenstroms befindet sich nicht im ZIP-Archivformat.

Gilt für:

ZipArchive(Stream, ZipArchiveMode)

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Initialisiert eine neue Instanz der ZipArchive Klasse aus dem angegebenen Datenstrom 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 Ausgabedatenstrom.

mode: ZipArchiveMode

Einer der Enumerationswerte, der angibt, ob das ZIP-Archiv zum Lesen, Erstellen oder Aktualisieren von Einträgen verwendet wird.

Ausnahmen

ArgumentException

Der Datenstrom ist bereits geschlossen, oder die Funktionen des Datenstroms stimmen nicht mit dem Modus überein.

ArgumentNullException

stream ist null.

ArgumentOutOfRangeException

mode ist ein ungültiger Wert.

InvalidDataException

Der Inhalt des Datenstroms konnte nicht als ZIP-Archiv interpretiert werden.

-oder-

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

-oder-

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

Hinweise

Wenn der mode Parameter auf Read"Festgelegt" festgelegt ist, muss der Datenstrom das Lesen unterstützen. Wenn der mode Parameter auf Create"Festgelegt" festgelegt ist, muss der Datenstrom das Schreiben unterstützen. Wenn der mode Parameter auf Update festgelegt ist, muss der Datenstrom Lese-, Schreib- und Suchvorgänge unterstützen.

Gilt für:

ZipArchive(Stream, ZipArchiveMode, Boolean)

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Initialisiert eine neue Instanz der ZipArchive Klasse im angegebenen Datenstrom für den angegebenen Modus und lässt optional den Datenstrom 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 Ausgabedatenstrom.

mode: ZipArchiveMode

Einer der Enumerationswerte, der angibt, ob das ZIP-Archiv zum Lesen, Erstellen oder Aktualisieren von Einträgen verwendet wird.

leaveOpen: Boolean

true wenn der Datenstrom geöffnet bleibt, nachdem das ZipArchive Objekt verworfen wurde; andernfalls false.

Ausnahmen

ArgumentException

Der Datenstrom ist bereits geschlossen, oder die Funktionen des Datenstroms stimmen nicht mit dem Modus überein.

ArgumentNullException

stream ist null.

ArgumentOutOfRangeException

mode ist ein ungültiger Wert.

InvalidDataException

Der Inhalt des Datenstroms konnte nicht als ZIP-Archiv interpretiert werden.

-oder-

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

-oder-

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

Hinweise

Gilt für:

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Quelle:: ZipArchive.cs

Initialisiert eine neue Instanz der ZipArchive Klasse im angegebenen Datenstrom für den angegebenen Modus, verwendet die angegebene Codierung für Eintragsnamen und lässt optional den Datenstrom 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 Ausgabedatenstrom.

mode: ZipArchiveMode

Einer der Enumerationswerte, der angibt, ob das ZIP-Archiv zum Lesen, Erstellen oder Aktualisieren von Einträgen verwendet wird.

leaveOpen: Boolean

true wenn der Datenstrom geöffnet bleibt, nachdem das ZipArchive Objekt verworfen wurde; andernfalls false.

entryNameEncoding: Encoding

Die Codierung, die beim Lesen oder Schreiben von Eintragsnamen und Kommentaren 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-Archivtools und -bibliotheken erforderlich ist, die utf-8-Codierung für Eintragsnamen oder Kommentare nicht unterstützen.

Ausnahmen

ArgumentException

Der Datenstrom ist bereits geschlossen, oder die Funktionen des Datenstroms stimmen nicht mit dem Modus überein.

-oder-

Eine andere Codierung als UTF-8 wird für die entryNameEncoding.

ArgumentNullException

stream ist null.

ArgumentOutOfRangeException

mode ist ein ungültiger Wert.

InvalidDataException

Der Inhalt des Datenstroms konnte nicht als ZIP-Archiv interpretiert werden.

-oder-

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

-oder-

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

Hinweise

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

Wenn die Sprachcodierungskennzeichnung (im allgemeinen Bit-Flag der lokalen Dateiheader) nicht festgelegt ist, wird die aktuelle Standardcodeseite des Systems verwendet, um den Eintragsnamen und den Kommentar zu decodieren.
Wenn die Sprachcodierungskennzeichnung festgelegt ist, wird UTF-8 verwendet, um den Eintragsnamen und den Kommentar zu decodieren.

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

Wenn die Sprachcodierungskennzeichnung nicht festgelegt ist, wird die angegebene entryNameEncoding Eigenschaft verwendet, um den Eintragsnamen und den Kommentar zu decodieren.
Wenn die Sprachcodierungskennzeichnung festgelegt ist, wird UTF-8 verwendet, um den Eintragsnamen und den Kommentar zu decodieren.

Wenn Sie in Archivdateien schreiben und entryNameEncoding auf null"Eintragsnamen" und "Kommentare" festgelegt sind, werden diese entsprechend den folgenden Regeln codiert:

Bei Eintragsnamen und Kommentaren, die Zeichen außerhalb des ASCII-Bereichs enthalten, wird das Sprachcodierungskennzeichnungszeichen festgelegt, und Eintragsnamen und Kommentare werden mithilfe von UTF-8 codiert.
Bei Eintragsnamen und Kommentaren, die nur ASCII-Zeichen enthalten, wird das Sprachcodierungskennzeichnungszeichen nicht festgelegt, und Eintragsnamen und Kommentare werden mithilfe der aktuellen Standardcodepage des Systems codiert.

Wenn Sie in Archivdateien schreiben und entryNameEncoding auf einen anderen Wert als nullfestgelegt sind, wird die angegebene entryNameEncoding Eigenschaft verwendet, um die Eintragsnamen und Kommentare in Byte zu codieren. Die Sprachcodierungskennzeichnung (im allgemeinen Bit-Flag des lokalen Dateiheaders) wird nur festgelegt, wenn die angegebene Codierung eine UTF-8-Codierung ist.

Gilt für:

Feedback

War diese Seite hilfreich?