Class XzArchive

Class XzArchive

Nome do espaço: Aspose.Zip.Xz Assembleia: Aspose.Zip.dll (25.5.0)

Esta classe representa o arquivo xz. Use-o para compilar e extrair arquivos xz.

public class XzArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object XzArchive

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

XzArchive(XzArchiveSettings)

Inicia uma nova instância da classe Aspose.Zip.Xz.XzArchive e compõe o arquivo em formato xz.

public XzArchive(XzArchiveSettings settings = null)

Parameters

settings XzArchiveSettings

Set de configuração arquivo xz específico: tamanho do dicionário, tamanho do bloco, tipo de verificação.

XzArchive(Stream)

Inicia uma nova instância da classe Aspose.Zip.Xz.XzArchive preparada para a decompressão.

public XzArchive(Stream source)

Parameters

source Stream

A fonte do arquivo.

Remarks

Veja Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) método para a decompressão.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

XzArchive(Redação)

Inicia uma nova instância da classe Aspose.Zip.Xz.XzArchive preparada para a decompressão.

public XzArchive(string path)

Parameters

path string

O caminho para a fonte do arquivo.

Remarks

Veja Aspose.Zip.Xz.XzArchive.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)

Extrair arquivo xz para um fluxo.

public void Extract(Stream destination)

Parameters

destination Stream

Fluxo para armazenamento de dados decomprimidos.

Examples

using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new XzArchive(xzFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

Exceptions

InvalidOperationException

Os títulos de arquivo e informações de serviço não foram lidos.

Extract(FileInfo)

Extrair arquivo xz para um arquivo.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo para armazenamento de dados decomprimidos.

Examples

using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new XzArchive(xzFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Exceptions

InvalidOperationException

Os títulos de arquivo e informações de serviço não foram lidos.

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.

Extract(Redação)

Extrair arquivo xz para um arquivo por caminho.

public FileInfo Extract(string path)

Parameters

path string

Caminho para arquivo que irá armazenar dados decomprimidos.

Returns

FileInfo

Instância System.IO.FileInfo contendo dados extraídos.

Examples

using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new XzArchive(xzFile))
    {
        archive.Extract("extracted.bin");
    }
}

Exceptions

InvalidOperationException

Os títulos de arquivo e informações de serviço não foram lidos.

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.

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(Stream)

Salve arquivo xz para o fluxo fornecido.

public void Save(Stream output)

Parameters

output Stream

fluxo de destino.

Examples

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

Remarks

Deve ser procurável.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(Redação)

Salve o arquivo xz para o ficheiro de destino fornecido.

public void Save(string destinationFileName)

Parameters

destinationFileName string

Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobreescrito.

Examples

using (var archive = new XzArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.xz");
}

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 XzArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.xz");
}

Exceptions

ArgumentException

O fluxo de fonte é indesejável.

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 XzArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.xz");
}

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 XzArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.xz");
}

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

O requerente não tem a permissão necessária para o acesso.

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