Class ZArchive
Nome do espaço: Aspose.Zip.Z Assembleia: Aspose.Zip.dll (25.5.0)
Esta classe representa um arquivo Z (comprimido). use-o para compor ou extrair arquivos Z.
public class ZArchive : 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()
Remarks
Ver https://docs.fileformat.com/compression/z/
Constructors
Arquivos()
Inicia uma nova instância da classe Aspose.Zip.Z.Archive preparada para a compressão.
public ZArchive()
Arquivos(Arquivo, ArquivoOpções)
Inicia uma nova instância da classe Aspose.Zip.ZArchive preparada para a decompressão.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)
Parameters
source
Stream
A fonte do arquivo.
loadOptions
ZArchiveLoadOptions
As opções para carregar arquivos com.
Remarks
Veja Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) método para a decompressão.
Exceptions
source’ is not seekable.
source’ is null.
Arquivos(Arquivo, Opções de Arquivo)
Inicia uma nova instância da classe Aspose.Zip.ZArchive preparada para a decompressão.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)
Parameters
path
string
O caminho para a fonte do arquivo.
loadOptions
ZArchiveLoadOptions
As opções para carregar arquivos com.
Remarks
Veja Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) método para a decompressã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.
O arquivo não foi encontrado.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo já está aberto.
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)
Extracto Z arquivo para um fluxo.
public void Extract(Stream destination)
Parameters
destination
Stream
Fluxo para armazenamento de dados decomprimidos.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(extractedFile);
}
}
}
Exceptions
Os dados não podem ser decomprimidos.
Extract(FileInfo)
Extrair arquivo Z para um arquivo.
public void Extract(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo para armazenamento de dados decomprimidos.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Exceptions
O chamador não tem a permissão necessária para abrir o fileInfo'.
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.
fileInfo’ is null.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo já está aberto.
Os dados não podem ser decomprimidos.
Extract(Redação)
Extrair arquivo Z para um arquivo por caminho.
public FileInfo Extract(string path)
Parameters
path
string
Caminho para arquivo que irá armazenar dados decomprimidos.
Returns
Informação sobre um arquivo extraído.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
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.
Os dados não podem ser decomprimidos.
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.
Save(Arquivo, ArquivoOpções)
Salve arquivo xz para o fluxo fornecido.
public void Save(Stream output, ZArchiveSaveOptions settings = null)
Parameters
output
Stream
fluxo de destino.
settings
ZArchiveSaveOptions
configurações opcionais para a composição de arquivos.
Examples
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}
Remarks
Deve ser procurável.
Exceptions
output’ does not support seeking.
output’ is null.
Save(Arquivos, ZArchiveOptions)
Salve o arquivo Z para o arquivo de destino fornecido.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)
Parameters
destinationFileName
string
+O caminho do arquivo para ser criado.Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobreescrito.
settings
ZArchiveSaveOptions
configurações opcionais para a composição de arquivos.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
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.
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 ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}
SetSource(FileInfo)
Coloca o conteúdo para ser comprimido dentro do arquivo.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo que será aberto como fluxo de entrada.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
Exceptions
O chamador não tem a permissão necessária para abrir o fileInfo'.
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.
fileInfo’ is null.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo já está aberto.
SetSource(Redação)
Coloca o conteúdo para ser comprimido dentro do arquivo.
public void SetSource(string sourcePath)
Parameters
sourcePath
string
O caminho para o arquivo que será aberto como fluxo de entrada.
Examples
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}
Exceptions
sourcePath’ is null or empty string.
O chamador não tem a permissão necessária para aceder a um recurso.
O sourcePath’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo sourcePath’ é negado.
O nome de arquivo especificado sourcePath, 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 em sourcePath’ contém uma coluna (:) no meio da linha.