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
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
path’ is null.
O requerente não tem a permissão necessária para o acesso.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
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
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
Informação sobre um arquivo extraído.
Exceptions
path’ is null.
O requerente não tem a permissão necessária para o acesso.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
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
destinationDirectory’ is null.
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.
O chamador não tem a permissão necessária para acessar o diretório existente.
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:”).
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 (:).
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
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
outputStream’ is not writable.
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
destinationFileName’ is null.
O requerente não tem a permissão necessária para o acesso.
A destinationFileName’ é vazia, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo destinationFileName’ é negado.
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.
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
O chamador não tem a permissão necessária para abrir a destination'.
O caminho do arquivo é vazio ou contém apenas espaços brancos.
O arquivo não foi encontrado.
O caminho para o arquivo é apenas leitura ou é um diretório.
destination’ is null.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
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
path’ is null.
O requerente não tem a permissão necessária para o acesso.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
O arquivo no path’ contém uma coluna (:) no meio da linha.