Class ZstandardArchive

path é nulo.

O chamador não tem a permissão necessária para acessar.

O path está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

O acesso ao arquivo path é negado.

O path especificado, nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos arquivos devem ter menos de 260 caracteres.

O arquivo em path contém dois pontos (:) no meio da string.

Métodos

Dispose()

Executa tarefas definidas pela aplicação associadas à liberação, liberação ou redefinição de recursos não gerenciados.

public void Dispose()

Dispose(bool)

Executa tarefas definidas pela aplicação associadas à liberação, liberação ou redefinição de recursos não gerenciados.

protected virtual void Dispose(bool disposing)

Parâmetros

disposing bool

Se os recursos gerenciados devem ser liberados.

Extract(Stream)

Extrai o archive para o stream fornecido.

public void Extract(Stream destination)

Parâmetros

destination Stream

Stream de destino. Deve ser gravável.

Exemplos

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

Exceções

destination não suporta gravação.

Extract(string)

Extrai o archive para o arquivo pelo caminho.

public FileInfo Extract(string path)

Parâmetros

path string

O caminho para o arquivo de destino. Se o arquivo já existir, ele será sobrescrito.

Retorna

FileInfo

Info do arquivo extraído.

Exceções

path é nulo.

O chamador não tem a permissão necessária para acessar.

O path está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

O acesso ao arquivo path é negado.

O arquivo em path contém dois pontos (:) no meio da string.

ExtractToDirectory(string)

Extrai o conteúdo do archive para o diretório fornecido.

public void ExtractToDirectory(string destinationDirectory)

Parâmetros

destinationDirectory string

O caminho para o diretório onde os arquivos extraídos serão colocados.

Observações

Se o diretório não existir, ele será criado.

Exceções

destinationDirectory é nulo.

O caminho especificado, nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos arquivos devem ter menos de 260 caracteres.

O chamador não tem a permissão necessária para acessar o diretório existente.

Se o diretório não existir, o caminho contém um caractere de dois pontos (:) que não faz parte de um rótulo de unidade (“C:").

destinationDirectory é uma string de comprimento zero, contém apenas espaços em branco ou contém um ou mais caracteres inválidos. Você pode consultar caracteres inválidos usando o método System.IO.Path.GetInvalidPathChars. -ou- o caminho é prefixado com, ou contém, apenas um caractere de dois pontos (:).

IOException

O diretório especificado pelo caminho é um arquivo. -ou- O nome da rede não é conhecido.

Open()

Abre o archive para extração e fornece um stream com o conteúdo do archive.

public Stream Open()

Retorna

Stream

O stream que representa o conteúdo do archive.

Exemplos

Extrai o archive e copia o conteúdo extraído para o stream do arquivo.

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Você pode usar o método Stream.CopyTo para .NET 4.0 e superior: `unpacked.CopyTo(extracted);`

Observações

Leia do stream para obter o conteúdo original do arquivo. Veja a seção de exemplos.

Save(Stream, ZstandardSaveOptions)

Salva o archive no stream fornecido.

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

Parâmetros

outputStream Stream

Stream de destino.

settings ZstandardSaveOptions

Configurações opcionais para a composição do archive.

Exemplos

Escreve dados comprimidos no stream de resposta http.

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

Observações

outputStream deve ser gravável.

Exceções

InvalidOperationException

outputStream não é gravável.

A fonte não foi fornecida.

Save(string, ZstandardSaveOptions)

Salva o archive no arquivo de destino fornecido.

public void Save(string destinationFileName, ZstandardSaveOptions settings = null)

Parâmetros

destinationFileName string

O caminho do archive a ser criado. Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobrescrito.

settings ZstandardSaveOptions

Configurações opcionais para a composição do archive.

Exemplos

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.zst");
}

Exceções

destinationFileName é nulo.

O chamador não tem a permissão necessária para acessar.

O destinationFileName está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

O acesso ao arquivo destinationFileName é negado.

O destinationFileName especificado, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos arquivos devem ter menos de 260 caracteres.

O arquivo em destinationFileName contém um dois pontos (:) no meio da string.

Save(FileInfo, ZstandardSaveOptions)

Salva o archive no arquivo de destino fornecido.

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

Parâmetros

destination FileInfo

FileInfo que será aberto como stream de destino.

settings ZstandardSaveOptions

Configurações opcionais para a composição do archive.

Exemplos

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.zst"));
}

Exceções

O chamador não tem a permissão necessária para abrir o destination.

O caminho do arquivo está vazio ou contém apenas espaços em branco.

FileNotFoundException

O arquivo não foi encontrado.

O caminho para o arquivo é somente leitura ou é um diretório.

DirectoryNotFoundException

destination é nulo.

O caminho especificado é inválido, como estar em uma unidade não mapeada.

IOException

O arquivo já está aberto.

SetSource(Stream)

Define o conteúdo a ser comprimido dentro do archive.

public void SetSource(Stream source)

Parâmetros

source Stream

O stream de entrada para o archive.

Exemplos

using (var archive = new ZstandardArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.zst");
}

SetSource(FileInfo)

Define o conteúdo a ser comprimido dentro do archive.

public void SetSource(FileInfo fileInfo)

Parâmetros

fileInfo FileInfo

A referência a um arquivo a ser comprimido.

Exemplos

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.zst");
}

SetSource(string)

Define o conteúdo a ser comprimido dentro do archive.

public void SetSource(string path)

Parâmetros

path string

Caminho para o arquivo a ser comprimido.

Exemplos

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.zst");
}

Exceções

path é nulo.

O chamador não tem a permissão necessária para acessar.

O path está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

O acesso ao arquivo path é negado.

O path especificado, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos arquivos devem ter menos de 260 caracteres.