ZipArchive Konstruktoren
Definition
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
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 null
festgelegt 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 null
festgelegt 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 null
festgelegt 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 null
festgelegt 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.