ZipArchive Construtores

Definição

Espaço de Nomes:: System.IO.Compression

Assemblagem:: System.IO.Compression.dll

Assemblagens:: netstandard.dll, System.IO.Compression.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da ZipArchive classe.

Sobrecargas

Name	Description
ZipArchive(Stream)	Inicializa uma nova instância da ZipArchive classe a partir do fluxo especificado.
ZipArchive(Stream, ZipArchiveMode)	Inicializa uma nova instância da ZipArchive classe a partir do 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 os nomes das entradas e, opcionalmente, deixa o fluxo aberto.

ZipArchive(Stream)

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Inicializa uma nova instância da ZipArchive classe a partir 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 riacho já está fechado ou não permite leitura.

ArgumentNullException

stream é null.

InvalidDataException

O conteúdo da transmissão não está no formato de arquivo postal.

Aplica-se a

ZipArchive(Stream, ZipArchiveMode)

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

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

mode: ZipArchiveMode

Um dos valores de enumeração indica se o arquivo zip é usado para ler, criar ou atualizar entradas.

Exceções

ArgumentException

O fluxo já está fechado, ou as capacidades do fluxo não correspondem ao modo.

ArgumentNullException

stream é null.

ArgumentOutOfRangeException

mode é um valor inválido.

InvalidDataException

O conteúdo da transmissão não podia ser interpretado como um arquivo postal.

-ou-

mode é Update e uma entrada está em falta no arquivo ou está corrompida e não pode ser lida.

-ou-

mode é Update e uma entrada é demasiado grande para caber na memória.

Observações

Se o mode parâmetro for definido para Read, o fluxo deve suportar leitura. Se o mode parâmetro estiver definido para Create, o fluxo deve suportar a escrita. Se o mode parâmetro estiver definido para Update, o fluxo deve suportar leitura, escrita e procura.

Aplica-se a

ZipArchive(Stream, ZipArchiveMode, Boolean)

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

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.ZipArchive

Public 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 indica se o arquivo zip é usado para ler, criar ou atualizar entradas.

leaveOpen: Boolean

true deixar o fluxo aberto após o ZipArchive objeto ser eliminado; caso contrário, false.

Exceções

ArgumentException

O fluxo já está fechado, ou as capacidades do fluxo não correspondem ao modo.

ArgumentNullException

stream é null.

ArgumentOutOfRangeException

mode é um valor inválido.

InvalidDataException

O conteúdo da transmissão não podia ser interpretado como um arquivo postal.

-ou-

mode é Update e uma entrada está em falta no arquivo ou está corrompida e não pode ser lida.

-ou-

mode é Update e uma entrada é demasiado grande para caber na memória.

Observações

Aplica-se a

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

Origem:: ZipArchive.cs

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

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 saída.

mode: ZipArchiveMode

Um dos valores de enumeração indica se o arquivo zip é usado para ler, criar ou atualizar entradas.

leaveOpen: Boolean

true deixar o fluxo aberto após o ZipArchive objeto ser eliminado; caso contrário, false.

entryNameEncoding: Encoding

A codificação a usar ao ler ou escrever nomes de entradas e comentários neste arquivo. Especifique um valor para este parâmetro apenas quando for necessária uma codificação para interoperabilidade com ferramentas de arquivo zip e bibliotecas que não suportem codificação UTF-8 para nomes de entradas ou comentários.

Exceções

ArgumentException

O fluxo já está fechado, ou as capacidades do fluxo não correspondem ao modo.

-ou-

Uma codificação diferente da UTF-8 é especificada para o entryNameEncoding.

ArgumentNullException

stream é null.

ArgumentOutOfRangeException

mode é um valor inválido.

InvalidDataException

O conteúdo da transmissão não podia ser interpretado como um arquivo postal.

-ou-

mode é Update e uma entrada está em falta no arquivo ou está corrompida e não pode ser lida.

-ou-

mode é Update e uma entrada é demasiado grande para caber na memória.

Observações

Quando abre um ficheiro zip para leitura e entryNameEncoding está definido para null, os nomes das entradas e comentários são decodificados de acordo com as seguintes regras:

Quando o flag de codificação da linguagem (no flag de bit de uso geral do cabeçalho local do ficheiro) não está definido, a página de código padrão do sistema atual é usada para decodificar o nome da entrada e o comentário.
Quando o flag de codificação da linguagem é definido, o UTF-8 é usado para decodificar o nome da entrada e o comentário.

Quando abre um ficheiro zip de arquivo para leitura e entryNameEncoding está definido para um valor diferente de null, os nomes das entradas e comentários são decodificados de acordo com as seguintes regras:

Quando o flag de codificação da linguagem não está definido, o especificado entryNameEncoding é usado para decifrar o nome da entrada e o comentário.
Quando o flag de codificação da linguagem é definido, o UTF-8 é usado para decodificar o nome da entrada e o comentário.

Quando escreve em ficheiros de arquivo e entryNameEncoding está definido para null, os nomes das entradas e comentários são codificados de acordo com as seguintes regras:

Para nomes de entrada e comentários que contenham caracteres fora do intervalo ASCII, a bandeira de codificação da linguagem é definida, e os nomes das entradas e comentários são codificados usando UTF-8.
Para nomes de entradas e comentários que contêm apenas caracteres ASCII, a bandeira de codificação da linguagem não está definida, e os nomes das entradas e comentários são codificados usando a página de códigos padrão do sistema atual.

Quando escreve em ficheiros de arquivo e entryNameEncoding está definido para um valor diferente de null, o especificado entryNameEncoding é usado para codificar os nomes das entradas e comentários em bytes. O flag de codificação da linguagem (no flag de bit de uso geral do cabeçalho local do ficheiro) é definido apenas quando a codificação especificada é uma codificação UTF-8.

Aplica-se a

Comentários

Esta página foi útil?