Class ZstandardArchive

Class ZstandardArchive

Nome do espaço: Aspose.Zip.Zstandard Assembleia: Aspose.Zip.dll (25.5.0)

Esta classe representa um arquivo padrão. Use-o para compilar arquivos padrão.

public class ZstandardArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZstandardArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

Membros herdados

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

ZstandardArchive()

Inicia uma nova instância da classe Aspose.Zip.Zstandard.ZstandardArchive preparada para compressão.

public ZstandardArchive()

Examples

O exemplo a seguir mostra como comprimir um arquivo.

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

ZstandardArchive(Título: ZstandardLoadOptions)

Inicia uma nova instância da classe Aspose.Zip.Zstandard.ZstandardArchive preparada para a decompressão.

public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)

Parameters

sourceStream Stream

A fonte do arquivo.

options ZstandardLoadOptions

As opções para carregar arquivos com.

Examples

Abra um arquivo de um fluxo e extrai-o para um

var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
  archive.Open().CopyTo(ms);

Remarks

Este fabricante não descomprime. ver Aspose.Zip.Zstandard.ZstandardArchive.Open método de descompressão.

ZstandardArchive(Título: ZstandardLoadOptions)

Inicia uma nova instância da classe Aspose.Zip.Zstandard.ZstandardArchive.

public ZstandardArchive(string path, ZstandardLoadOptions options = null)

Parameters

path string

O caminho para o arquivo.

options ZstandardLoadOptions

As opções para carregar arquivos com.

Examples

Abra um arquivo do ficheiro por caminho e extraí-lo para um

var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
  archive.Open().CopyTo(ms);

Remarks

Este fabricante não descomprime. ver Aspose.Zip.Zstandard.ZstandardArchive.Open método de descompressão.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

O requerente não tem a permissão necessária para o acesso.

ArgumentException

O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo path" é negado.

PathTooLongException

O nome de arquivo especificado path", ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres.

NotSupportedException

O arquivo no path’ contém uma coluna (:) no meio da linha.

Methods

Dispose()

Exerce tarefas definidas por aplicação associadas à libertação, libertação ou restauração de recursos não gerenciados.

public void Dispose()

Dispose(Bolha)

Exerce tarefas definidas por aplicação associadas à libertação, libertação ou restauração de recursos não gerenciados.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Se os recursos gerenciados devem ser dissolvidos.

Extract(Stream)

Extrair o arquivo para o fluxo fornecido.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. deve ser escrita.

Examples

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

Exceptions

ArgumentException

destination’ does not support writing.

Extract(Redação)

Extrair o arquivo para o arquivo por caminho.

public FileInfo Extract(string path)

Parameters

path string

O caminho para o arquivo de destino.Se o arquivo já existe, será sobreescrito.

Returns

FileInfo

Informação sobre um arquivo extraído.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

O requerente não tem a permissão necessária para o acesso.

ArgumentException

O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo path" é negado.

PathTooLongException

O nome de arquivo especificado path", ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres.

NotSupportedException

O arquivo no path’ contém uma coluna (:) no meio da linha.

ExtractToDirectory(Redação)

Extrair o conteúdo do arquivo para o diretório fornecido.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

O caminho para o diretório para colocar os arquivos extraídos.

Remarks

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

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

O caminho especificado, o nome do arquivo ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres e os nomes do arquivo devem ser menores de 260 caracteres.

SecurityException

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

NotSupportedException

Se o diretório não existe, o caminho contém um caráter colon (:) que não faz parte de uma etiqueta de disco (“C:”).

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

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

Open()

Abre o arquivo para extração e fornece um fluxo com conteúdo de arquivo.

public Stream Open()

Returns

Stream

O fluxo que representa o conteúdo do arquivo.

Examples

Extrata o arquivo e copia o conteúdo extraído para o fluxo de 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 < (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.Kopy To(extraído);’

Remarks

Leia do fluxo para obter o conteúdo original de um arquivo. ver seção exemplos.

Save(Opções de streaming, ZstandardSaveOptions)

Salve arquivo para o fluxo fornecido.

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

Parameters

outputStream Stream

fluxo de destino.

settings ZstandardSaveOptions

configurações opcionais para a composição de arquivos.

Examples

Escreva dados comprimidos para o fluxo de resposta HTTP.

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

Remarks

Tem que ser escrita.

Exceptions

ArgumentException

outputStream’ is not writable.

InvalidOperationException

A fonte não foi fornecida.

Save(Título: ZstandardSaveOptions)

Salve arquivo para o arquivo de destino fornecido.

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

Parameters

destinationFileName string

Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobreescrito.

settings ZstandardSaveOptions

configurações opcionais para a composição de arquivos.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

O requerente não tem a permissão necessária para o acesso.

ArgumentException

A destinationFileName’ é vazia, contém apenas espaços brancos, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo destinationFileName’ é negado.

PathTooLongException

O nome de arquivo especificado destinationFileName, ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres.

NotSupportedException

O arquivo na destinationFileName’ contém uma coluna (:) no meio da linha.

Save(Ficheiro, ZstandardSaveOptions)

Salve arquivo para o arquivo de destino fornecido.

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

Parameters

destination FileInfo

FileInfo, que será aberto como fluxo de destino.

settings ZstandardSaveOptions

configurações opcionais para a composição de arquivos.

Examples

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

Exceptions

SecurityException

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

ArgumentException

O caminho do arquivo é vazio ou contém apenas espaços brancos.

FileNotFoundException

O arquivo não foi encontrado.

UnauthorizedAccessException

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

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

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

IOException

O arquivo já está aberto.

SetSource(Stream)

Coloca o conteúdo para ser comprimido dentro do arquivo.

public void SetSource(Stream source)

Parameters

source Stream

O fluxo de entrada para o arquivo.

Examples

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

SetSource(FileInfo)

Coloca o conteúdo para ser comprimido dentro do arquivo.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

A referência a um arquivo a ser comprimido.

Examples

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

SetSource(Redação)

Coloca o conteúdo para ser comprimido dentro do arquivo.

public void SetSource(string path)

Parameters

path string

O caminho para o arquivo ser comprimido.

Examples

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

O requerente não tem a permissão necessária para o acesso.

ArgumentException

O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo path" é negado.

PathTooLongException

O nome de arquivo especificado path", ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres.

NotSupportedException

O arquivo no path’ contém uma coluna (:) no meio da linha.

 Português