ZipArchive Construtores

Definição

Inicializa uma nova instância da classe ZipArchive.

Sobrecargas

ZipArchive(Stream)

Inicializa uma nova instância da classe ZipArchive do fluxo especificado.

ZipArchive(Stream, ZipArchiveMode)

Inicializa uma nova instância da classe ZipArchive no fluxo especificado e com o modo especificado.

ZipArchive(Stream, ZipArchiveMode, Boolean)

Inicializa uma nova instância da classe ZipArchive no fluxo especificado para o modo especificado e, opcionalmente, deixa o fluxo aberto.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Inicializa uma nova instância da classe ZipArchive no fluxo especificado para o modo especificado, usa a codificação especificada para nomes de entrada e, como opção, deixa o fluxo aberto.

ZipArchive(Stream)

Origem:
ZipArchive.cs
Origem:
ZipArchive.cs
Origem:
ZipArchive.cs

Inicializa uma nova instância da classe ZipArchive do fluxo especificado.

public ZipArchive (System.IO.Stream 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

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ZipArchive(Stream, ZipArchiveMode)

Origem:
ZipArchive.cs
Origem:
ZipArchive.cs
Origem:
ZipArchive.cs

Inicializa uma nova instância da classe ZipArchive no fluxo especificado e com o modo especificado.

public ZipArchive (System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode);

Parâmetros

stream
Stream

O fluxo de entrada ou de 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.

Não foi possível interpretar o conteúdo do fluxo como um arquivo zip.

- ou -

mode é Update e uma entrada está ausente do arquivo 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 Create, o fluxo deverá dar suporte à gravação. Se o mode parâmetro for definido como , o fluxo deverá dar suporte à Updateleitura, gravação e busca.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ZipArchive(Stream, ZipArchiveMode, Boolean)

Origem:
ZipArchive.cs
Origem:
ZipArchive.cs
Origem:
ZipArchive.cs

Inicializa uma nova instância da classe ZipArchive 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);

Parâmetros

stream
Stream

O fluxo de entrada ou de 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 após o objeto ZipArchive ser 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.

Não foi possível interpretar o conteúdo do fluxo como um arquivo zip.

- ou -

mode é Update e uma entrada está ausente do arquivo 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 Create, o fluxo deverá dar suporte à gravação. Se o mode parâmetro for definido como , o fluxo deverá dar suporte à Updateleitura, gravação e busca.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Origem:
ZipArchive.cs
Origem:
ZipArchive.cs
Origem:
ZipArchive.cs

Inicializa uma nova instância da classe ZipArchive no fluxo especificado para o modo especificado, usa a codificação especificada para nomes de entrada e, como opção, 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);

Parâmetros

stream
Stream

O fluxo de entrada ou de 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 após o objeto ZipArchive ser descartado; caso contrário, false.

entryNameEncoding
Encoding

A codificação a ser usada ao ler ou gravar nomes de entrada nesse arquivo. Especifique um valor para esse parâmetro somente quando uma codificação for necessária para a interoperabilidade com ferramentas de arquivo zip e bibliotecas que não dão suporte à codificação UTF-8 para nomes de entrada.

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.

Não foi possível interpretar o conteúdo do fluxo como um arquivo zip.

- ou -

mode é Update e uma entrada está ausente do arquivo 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 Create, o fluxo deverá dar suporte à gravação. Se o mode parâmetro for definido como , o fluxo deverá dar suporte à Updateleitura, gravação e busca.

Quando você abre um arquivo zip para leitura e entryNameEncoding é definido nullcomo , os nomes de entrada 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 do arquivo local) não é definido, a página de código padrão do sistema atual é usada para decodificar o nome da entrada.

  • Quando o sinalizador de codificação de idioma é definido, UTF-8 é usado para decodificar o nome da entrada.

Quando você abre um arquivo zip para leitura e entryNameEncoding é definido como um valor diferente nullde , os nomes de entrada são decodificados de acordo com as seguintes regras:

  • Quando o sinalizador de codificação de idioma não está definido, o especificado entryNameEncoding é usado para decodificar o nome da entrada.

  • Quando o sinalizador de codificação de idioma é definido, UTF-8 é usado para decodificar o nome da entrada.

Quando você grava em arquivos de arquivo morto e entryNameEncoding é definido nullcomo , os nomes de entrada são codificados de acordo com as seguintes regras:

  • Para nomes de entrada que contêm caracteres fora do intervalo ASCII, o sinalizador de codificação de idioma é definido e os nomes de entrada são codificados usando UTF-8.

  • Para nomes de entrada que contêm apenas caracteres ASCII, o sinalizador de codificação de idioma não está definido e os nomes de entrada 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 de null, o especificado entryNameEncoding é usado para codificar os nomes de entrada 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.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0