Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
Esta classe representa um arquivo de arquivo Z (compactar). Use-a para compor ou extrair arquivos Z.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntry
Herança
Implementa
IArchive, IDisposable, IArchiveFileEntry
Membros Herdados
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Comentários
Veja https://docs.fileformat.com/compression/z/
Construtores
ZArchive()
Inicializa uma nova instância da classe Aspose.Zip.Z.ZArchive preparada para compactar.
public ZArchive()
ZArchive(Stream, ZArchiveLoadOptions)
Inicializa uma nova instância da classe Aspose.Zip.Z.ZArchive preparada para descompactar.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)
Parâmetros
source
Stream
A fonte do arquivo.
loadOptions
ZArchiveLoadOptions
As opções para carregar o arquivo.
Comentários
Este construtor não descompacta. Veja o método Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) para descompactação.
Exceções
source
não é buscável.
source
é nulo.
ZArchive(string, ZArchiveLoadOptions)
Inicializa uma nova instância da classe Aspose.Zip.Z.ZArchive preparada para descompactar.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)
Parâmetros
path
string
Caminho para a fonte do arquivo.
loadOptions
ZArchiveLoadOptions
As opções para carregar o arquivo.
Comentários
Este construtor não descompacta. Veja o método Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) para descompactação.
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.
Acesso ao arquivo path
foi negado.
O path
, 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.
O arquivo não foi encontrado.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo já está aberto.
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 arquivo Z para um stream.
public void Extract(Stream destination)
Parâmetros
destination
Stream
Stream para armazenar os dados descompactados.
Exemplos
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);
}
}
}
Exceções
Os dados não podem ser descompactados.
Extract(FileInfo)
Extrai o arquivo Z para um arquivo.
public void Extract(FileInfo fileInfo)
Parâmetros
fileInfo
FileInfo
FileInfo para armazenar os dados descompactados.
Exemplos
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Exceções
O chamador não tem a permissão necessária para abrir o fileInfo
.
O caminho do arquivo está vazio ou contém apenas espaços em branco.
O arquivo não foi encontrado.
O caminho para o arquivo é somente leitura ou é um diretório.
fileInfo
é nulo.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo já está aberto.
Os dados não podem ser descompactados.
Extract(string)
Extrai o arquivo Z para um arquivo pelo caminho.
public FileInfo Extract(string path)
Parâmetros
path
string
Caminho para o arquivo que armazenará os dados descompactados.
Retorna
Informações do arquivo extraído.
Exemplos
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
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.
Acesso ao arquivo path
foi negado.
O path
, 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.
Os dados não podem ser descompactados.
ExtractToDirectory(string)
Extrai o conteúdo do arquivo 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.
Comentários
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 (:).
O diretório especificado pelo caminho é um arquivo. -ou- O nome da rede não é conhecido.
Save(Stream, ZArchiveSaveOptions)
Salva o arquivo xz no stream fornecido.
public void Save(Stream output, ZArchiveSaveOptions settings = null)
Parâmetros
output
Stream
Stream de destino.
settings
ZArchiveSaveOptions
Configurações opcionais para a composição do arquivo.
Exemplos
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}
Comentários
output
deve ser buscável.
Exceções
output
não suporta busca.
output
é nulo.
Save(string, ZArchiveSaveOptions)
Salva o arquivo Z no arquivo de destino fornecido.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)
Parâmetros
destinationFileName
string
- O caminho do arquivo a ser criado. Se o nome do arquivo especificado apontar para um arquivo existente, ele será sobrescrito.
settings
ZArchiveSaveOptions
Configurações opcionais para a composição do arquivo.
Exemplos
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
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.
Acesso ao arquivo destinationFileName
foi negado.
O destinationFileName
, 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 dois pontos (:) no meio da string.
SetSource(Stream)
Define o conteúdo a ser compactado dentro do arquivo.
public void SetSource(Stream source)
Parâmetros
source
Stream
O stream de entrada para o arquivo.
Exemplos
using (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}
SetSource(FileInfo)
Define o conteúdo a ser compactado dentro do arquivo.
public void SetSource(FileInfo fileInfo)
Parâmetros
fileInfo
FileInfo
FileInfo que será aberto como stream de entrada.
Exemplos
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
Exceções
O chamador não tem a permissão necessária para abrir o fileInfo
.
O caminho do arquivo está vazio ou contém apenas espaços em branco.
O arquivo não foi encontrado.
O caminho para o arquivo é somente leitura ou é um diretório.
fileInfo
é nulo.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo já está aberto.
SetSource(string)
Define o conteúdo a ser compactado dentro do arquivo.
public void SetSource(string sourcePath)
Parâmetros
sourcePath
string
Caminho para o arquivo que será aberto como stream de entrada.
Exemplos
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}
Exceções
sourcePath
é nulo ou uma string vazia.
O chamador não tem a permissão necessária para acessar um recurso.
O sourcePath
está vazio, contém apenas espaços em branco ou contém caracteres inválidos.
Acesso ao arquivo sourcePath
foi negado.
O sourcePath
, 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 sourcePath
contém dois pontos (:) no meio da string.