ZipArchive Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe ZipArchive.
Sobrecargas
| Nome | Description |
|---|---|
| ZipArchive(Stream) |
Inicializa uma nova instância da classe do ZipArchive fluxo especificado. |
| ZipArchive(Stream, ZipArchiveMode) |
Inicializa uma nova instância da classe do ZipArchive fluxo especificado e com o modo especificado. |
| ZipArchive(Stream, ZipArchiveMode, Boolean) |
Inicializa uma nova instância da ZipArchive classe no fluxo especificado para o modo especificado e, opcionalmente, deixa o fluxo aberto. |
| ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding) |
Inicializa uma nova instância da ZipArchive classe no fluxo especificado para o modo especificado, usa a codificação especificada para nomes de entrada e, opcionalmente, deixa o fluxo aberto. |
ZipArchive(Stream)
Inicializa uma nova instância da classe do ZipArchive fluxo especificado.
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)Parâmetros
- stream
- Stream
O fluxo que contém o arquivo a ser lido.
Exceções
O fluxo já está fechado ou não dá suporte à leitura.
stream é null.
O conteúdo do fluxo não está no formato de arquivo zip.
Aplica-se a
ZipArchive(Stream, ZipArchiveMode)
Inicializa uma nova instância da classe do ZipArchive fluxo especificado e com o modo especificado.
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)Parâmetros
- stream
- Stream
O fluxo de entrada ou saída.
- mode
- ZipArchiveMode
Um dos valores de enumeração que indica se o arquivo zip é usado para ler, criar ou atualizar entradas.
Exceções
O fluxo já está fechado ou os recursos do fluxo não correspondem ao modo.
stream é null.
mode é um valor inválido.
O conteúdo do fluxo não pôde ser interpretado como um arquivo zip.
-ou-
mode é Update e uma entrada está ausente do arquivo morto ou está corrompida e não pode ser lida.
-ou-
mode é Update e uma entrada é muito grande para caber na memória.
Comentários
Se o mode parâmetro for definido como, o fluxo deverá dar suporte à Readleitura. Se o mode parâmetro for definido como, o fluxo deverá dar suporte à Creategravação. Se o mode parâmetro estiver definido como, o fluxo deverá dar suporte à Updateleitura, gravação e busca.
Aplica-se a
ZipArchive(Stream, ZipArchiveMode, Boolean)
Inicializa uma nova instância da ZipArchive classe no fluxo especificado para o modo especificado e, opcionalmente, deixa o fluxo aberto.
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)Parâmetros
- stream
- Stream
O fluxo de entrada ou saída.
- mode
- ZipArchiveMode
Um dos valores de enumeração que indica se o arquivo zip é usado para ler, criar ou atualizar entradas.
- leaveOpen
- Boolean
true para deixar o fluxo aberto depois que o ZipArchive objeto for descartado; caso contrário, false.
Exceções
O fluxo já está fechado ou os recursos do fluxo não correspondem ao modo.
stream é null.
mode é um valor inválido.
O conteúdo do fluxo não pôde ser interpretado como um arquivo zip.
-ou-
mode é Update e uma entrada está ausente do arquivo morto ou está corrompida e não pode ser lida.
-ou-
mode é Update e uma entrada é muito grande para caber na memória.
Comentários
Se o mode parâmetro for definido como, o fluxo deverá dar suporte à Readleitura. Se o mode parâmetro for definido como, o fluxo deverá dar suporte à Creategravação. Se o mode parâmetro estiver definido como, o fluxo deverá dar suporte à Updateleitura, gravação e busca.
Aplica-se a
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)
Inicializa uma nova instância da ZipArchive classe no fluxo especificado para o modo especificado, usa a codificação especificada para nomes de entrada e, opcionalmente, deixa o fluxo aberto.
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)Parâmetros
- stream
- Stream
O fluxo de entrada ou saída.
- mode
- ZipArchiveMode
Um dos valores de enumeração que indica se o arquivo zip é usado para ler, criar ou atualizar entradas.
- leaveOpen
- Boolean
true para deixar o fluxo aberto depois que o ZipArchive objeto for descartado; caso contrário, false.
- entryNameEncoding
- Encoding
A codificação a ser usada ao ler ou gravar nomes de entrada e comentários neste arquivo morto. Especifique um valor para esse parâmetro somente quando uma codificação for necessária para interoperabilidade com ferramentas de arquivo zip e bibliotecas que não dão suporte à codificação UTF-8 para nomes de entrada ou comentários.
Exceções
O fluxo já está fechado ou os recursos do fluxo não correspondem ao modo.
-ou-
Uma codificação diferente de UTF-8 é especificada para o entryNameEncoding.
stream é null.
mode é um valor inválido.
O conteúdo do fluxo não pôde ser interpretado como um arquivo zip.
-ou-
mode é Update e uma entrada está ausente do arquivo morto ou está corrompida e não pode ser lida.
-ou-
mode é Update e uma entrada é muito grande para caber na memória.
Comentários
Se o mode parâmetro for definido como, o fluxo deverá dar suporte à Readleitura. Se o mode parâmetro for definido como, o fluxo deverá dar suporte à Creategravação. Se o mode parâmetro estiver definido como, o fluxo deverá dar suporte à Updateleitura, gravação e busca.
Quando você abre um arquivo zip archive para leitura e entryNameEncoding é definido como null, os nomes de entrada e os comentários são decodificados de acordo com as seguintes regras:
- Quando o sinalizador de codificação de idioma (no sinalizador de bits de uso geral do cabeçalho de arquivo local) não é definido, a página de código padrão do sistema atual é usada para decodificar o nome de entrada e o comentário.
- Quando o sinalizador de codificação de idioma é definido, UTF-8 é usado para decodificar o nome e o comentário da entrada.
Quando você abre um arquivo zip archive para leitura e entryNameEncoding é definido como um valor diferente nullde , nomes de entrada e comentários são decodificados de acordo com as seguintes regras:
- Quando o sinalizador de codificação de idioma não é definido, o especificado
entryNameEncodingé usado para decodificar o nome e o comentário da entrada. - Quando o sinalizador de codificação de idioma é definido, UTF-8 é usado para decodificar o nome e o comentário da entrada.
Quando você grava em arquivos arquivados e entryNameEncoding é definido como null, os nomes de entrada e os comentários são codificados de acordo com as seguintes regras:
- Para nomes de entrada e comentários que contêm caracteres fora do intervalo ASCII, o sinalizador de codificação de idioma é definido e os nomes de entrada e comentários são codificados usando UTF-8.
- Para nomes de entrada e comentários que contêm apenas caracteres ASCII, o sinalizador de codificação de idioma não está definido e os nomes de entrada e comentários são codificados usando a página de código padrão do sistema atual.
Quando você grava em arquivos de arquivo morto e entryNameEncoding é definido como um valor diferente null, o especificado entryNameEncoding é usado para codificar os nomes de entrada e comentários em bytes. O sinalizador de codificação de idioma (no sinalizador de bits de uso geral do cabeçalho do arquivo local) é definido somente quando a codificação especificada é uma codificação UTF-8.