Class ZArchive

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.

DirectoryNotFoundException

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

FileNotFoundException

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

InvalidDataException

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.

FileNotFoundException

O arquivo não foi encontrado.

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

DirectoryNotFoundException

fileInfo é nulo.

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

O arquivo já está aberto.

InvalidDataException

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

FileInfo

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.

InvalidDataException

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.

FileNotFoundException

O arquivo não foi encontrado.

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

DirectoryNotFoundException

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.