ZipArchive Construtores

Definição

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.dll

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

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

Public Sub New (stream As Stream)

Parâmetros

stream

Stream

O fluxo que contém o arquivo a ser lido.

Exceções

ArgumentException

O fluxo já está fechado ou não dá suporte à leitura.

ArgumentNullException

stream é null.

InvalidDataException

O conteúdo do fluxo não está no formato de arquivo zip.

ZipArchive(Stream, ZipArchiveMode)

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);

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)

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

ArgumentException

O fluxo já está fechado ou os recursos do fluxo não correspondem ao modo.

ArgumentNullException

stream é null.

ArgumentOutOfRangeException

mode é um valor inválido.

InvalidDataException

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.

ZipArchive(Stream, ZipArchiveMode, Boolean)

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);

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)

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

ArgumentException

O fluxo já está fechado ou os recursos do fluxo não correspondem ao modo.

ArgumentNullException

stream é null.

ArgumentOutOfRangeException

mode é um valor inválido.

InvalidDataException

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.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

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);

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)

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

ArgumentException

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.

ArgumentNullException

stream é null.

ArgumentOutOfRangeException

mode é um valor inválido.

InvalidDataException

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.