Class ZArchive

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

object ZArchive

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

ArgumentException

source’ is not seekable.

ArgumentNullException

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

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.

FileNotFoundException

O arquivo não foi encontrado.

DirectoryNotFoundException

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

IOException

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

InvalidDataException

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

SecurityException

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

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

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

O arquivo já está aberto.

InvalidDataException

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

FileInfo

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

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.

InvalidDataException

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

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.

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

ArgumentException

output’ does not support seeking.

ArgumentNullException

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

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.

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

SecurityException

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

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

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

O chamador não tem a permissão necessária para aceder a um recurso.

ArgumentException

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

UnauthorizedAccessException

O acesso ao arquivo sourcePath’ é negado.

PathTooLongException

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.

NotSupportedException

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

 Português