ZipArchive Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert een nieuw exemplaar van de ZipArchive klasse.
Overloads
| Name | Description |
|---|---|
| ZipArchive(Stream) |
Initialiseert een nieuw exemplaar van de ZipArchive klasse uit de opgegeven stream. |
| ZipArchive(Stream, ZipArchiveMode) |
Initialiseert een nieuw exemplaar van de ZipArchive klasse uit de opgegeven stream en met de opgegeven modus. |
| ZipArchive(Stream, ZipArchiveMode, Boolean) |
Initialiseert een nieuw exemplaar van de ZipArchive klasse in de opgegeven stream voor de opgegeven modus en laat de stream eventueel open. |
| ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding) |
Initialiseert een nieuw exemplaar van de ZipArchive klasse in de opgegeven stroom voor de opgegeven modus, gebruikt de opgegeven codering voor vermeldingsnamen en laat de stroom eventueel open. |
ZipArchive(Stream)
Initialiseert een nieuw exemplaar van de ZipArchive klasse uit de opgegeven stream.
public:
ZipArchive(System::IO::Stream ^ stream);public ZipArchive(System.IO.Stream stream);new System.IO.Compression.ZipArchive : System.IO.Stream -> System.IO.Compression.ZipArchivePublic Sub New (stream As Stream)Parameters
- stream
- Stream
De stroom die het archief bevat dat moet worden gelezen.
Uitzonderingen
De stream is al gesloten of biedt geen ondersteuning voor lezen.
stream is null.
De inhoud van de stream heeft geen zip-archiefindeling.
Van toepassing op
ZipArchive(Stream, ZipArchiveMode)
Initialiseert een nieuw exemplaar van de ZipArchive klasse uit de opgegeven stream en met de opgegeven 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.ZipArchivePublic Sub New (stream As Stream, mode As ZipArchiveMode)Parameters
- stream
- Stream
De invoer- of uitvoerstroom.
- mode
- ZipArchiveMode
Een van de opsommingswaarden die aangeven of het zip-archief wordt gebruikt om vermeldingen te lezen, te maken of bij te werken.
Uitzonderingen
De stream is al gesloten of de mogelijkheden van de stream komen niet overeen met de modus.
stream is null.
mode is een ongeldige waarde.
De inhoud van de stream kan niet worden geïnterpreteerd als een zip-archief.
– of –
mode is Update en een vermelding ontbreekt in het archief of is beschadigd en kan niet worden gelezen.
– of –
mode is Update en een ingang is te groot om in het geheugen te passen.
Opmerkingen
Als de mode parameter is ingesteld op Read, moet de stream het lezen ondersteunen. Als de mode parameter is ingesteld op Create, moet de stream ondersteuning bieden voor schrijven. Als de mode parameter is ingesteld op Update, moet de stream ondersteuning bieden voor lezen, schrijven en zoeken.
Van toepassing op
ZipArchive(Stream, ZipArchiveMode, Boolean)
Initialiseert een nieuw exemplaar van de ZipArchive klasse in de opgegeven stream voor de opgegeven modus en laat de stream eventueel open.
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.ZipArchivePublic Sub New (stream As Stream, mode As ZipArchiveMode, leaveOpen As Boolean)Parameters
- stream
- Stream
De invoer- of uitvoerstroom.
- mode
- ZipArchiveMode
Een van de opsommingswaarden die aangeven of het zip-archief wordt gebruikt om vermeldingen te lezen, te maken of bij te werken.
- leaveOpen
- Boolean
true om de stroom open te laten nadat het ZipArchive object is verwijderd; falseanders.
Uitzonderingen
De stream is al gesloten of de mogelijkheden van de stream komen niet overeen met de modus.
stream is null.
mode is een ongeldige waarde.
De inhoud van de stream kan niet worden geïnterpreteerd als een zip-archief.
– of –
mode is Update en een vermelding ontbreekt in het archief of is beschadigd en kan niet worden gelezen.
– of –
mode is Update en een ingang is te groot om in het geheugen te passen.
Opmerkingen
Als de mode parameter is ingesteld op Read, moet de stream het lezen ondersteunen. Als de mode parameter is ingesteld op Create, moet de stream ondersteuning bieden voor schrijven. Als de mode parameter is ingesteld op Update, moet de stream ondersteuning bieden voor lezen, schrijven en zoeken.
Van toepassing op
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)
Initialiseert een nieuw exemplaar van de ZipArchive klasse in de opgegeven stroom voor de opgegeven modus, gebruikt de opgegeven codering voor vermeldingsnamen en laat de stroom eventueel open.
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.ZipArchivePublic Sub New (stream As Stream, mode As ZipArchiveMode, leaveOpen As Boolean, entryNameEncoding As Encoding)Parameters
- stream
- Stream
De invoer- of uitvoerstroom.
- mode
- ZipArchiveMode
Een van de opsommingswaarden die aangeven of het zip-archief wordt gebruikt om vermeldingen te lezen, te maken of bij te werken.
- leaveOpen
- Boolean
true om de stroom open te laten nadat het ZipArchive object is verwijderd; falseanders.
- entryNameEncoding
- Encoding
De codering die moet worden gebruikt bij het lezen of schrijven van invoernamen en opmerkingen in dit archief. Geef alleen een waarde op voor deze parameter wanneer een codering is vereist voor interoperabiliteit met zip-archiefhulpprogramma's en -bibliotheken die UTF-8-codering niet ondersteunen voor vermeldingsnamen of opmerkingen.
Uitzonderingen
De stream is al gesloten of de mogelijkheden van de stream komen niet overeen met de modus.
– of –
Een andere codering dan UTF-8 is opgegeven voor de entryNameEncoding.
stream is null.
mode is een ongeldige waarde.
De inhoud van de stream kan niet worden geïnterpreteerd als een zip-archief.
– of –
mode is Update en een vermelding ontbreekt in het archief of is beschadigd en kan niet worden gelezen.
– of –
mode is Update en een ingang is te groot om in het geheugen te passen.
Opmerkingen
Als de mode parameter is ingesteld op Read, moet de stream het lezen ondersteunen. Als de mode parameter is ingesteld op Create, moet de stream ondersteuning bieden voor schrijven. Als de mode parameter is ingesteld op Update, moet de stream ondersteuning bieden voor lezen, schrijven en zoeken.
Wanneer u een zip-archiefbestand opent voor lezen en entryNameEncoding is ingesteld op null, worden invoernamen en opmerkingen gedecodeerd volgens de volgende regels:
- Wanneer de vlag voor taalcodering (in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst) niet is ingesteld, wordt de standaardcodepagina van het huidige systeem gebruikt om de naam en opmerking van de vermelding te decoderen.
- Wanneer de vlag voor taalcodering is ingesteld, wordt UTF-8 gebruikt om de vermeldingsnaam en opmerking te decoderen.
Wanneer u een zip-archiefbestand opent voor lezen en entryNameEncoding is ingesteld op een andere waarde dan null, worden invoernamen en opmerkingen gedecodeerd volgens de volgende regels:
- Wanneer de vlag voor taalcodering niet is ingesteld, wordt de opgegeven
entryNameEncodingvlag gebruikt om de vermeldingsnaam en opmerking te decoderen. - Wanneer de vlag voor taalcodering is ingesteld, wordt UTF-8 gebruikt om de vermeldingsnaam en opmerking te decoderen.
Wanneer u naar archiefbestanden schrijft en entryNameEncoding is ingesteld op null, worden vermeldingsnamen en opmerkingen gecodeerd volgens de volgende regels:
- Voor invoernamen en opmerkingen die tekens bevatten buiten het ASCII-bereik, wordt de vlag voor taalcodering ingesteld en worden vermeldingsnamen en opmerkingen gecodeerd met behulp van UTF-8.
- Voor invoernamen en opmerkingen die alleen ASCII-tekens bevatten, is de taalcoderingsvlag niet ingesteld en worden vermeldingsnamen en opmerkingen gecodeerd met behulp van de huidige standaardcodepagina van het systeem.
Wanneer u naar archiefbestanden schrijft en entryNameEncoding is ingesteld op een andere waarde dan null, wordt de opgegeven entryNameEncoding waarde gebruikt om de invoernamen en opmerkingen te coderen in bytes. De taalcoderingsvlag (in de vlag voor algemeen gebruik van de lokale bestandskoptekst) wordt alleen ingesteld wanneer de opgegeven codering een UTF-8-codering is.