Class CpioArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid cpio archive.

`CpioArchive(Redação)`

Inicia uma nova instância da classe Aspose.Zip.Cpio.CpioArchive e compõe uma lista de entrada que pode ser extraída do arquivo.

public CpioArchive(string path)

`Parameters`

path string

O caminho para o arquivo.

`Examples`

O exemplo a seguir mostra como extrair todas as entradas para um diretório.

using (var archive = new CpioArchive("archive.cpio")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

`Remarks`

Este fabricante não despaque qualquer entrada. ver Aspose.Zip.Cpio.CpioEntry.Open método para despaque.

`Exceptions`

path’ is null.

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

UnauthorizedAccessException

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.

DirectoryNotFoundException

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

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.

`Properties`

`Entries`

Obtenha entradas do tipo Aspose.Zip.Cpio.CpioEntry que constituem o arquivo.

public ReadOnlyCollection<cpioentry> Entries { get; }

`Valor da propriedade`

ReadOnlyCollection e o PT; CpioEntry >

`Methods`

`CreateEntries(Remoção, Bool)`

Adicione ao arquivo todos os arquivos e diretórios repetidamente no diretório dado.

public CpioArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

`Parameters`

sourceDirectory string

Diretório para compressão.

includeRootDirectory bool

Indica se incluir o diretório de raiz ou não.

`Returns`

Introdução à instância.

`Examples`

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(cpioFile);
    }
}

`Exceptions`

sourceDirectory’ is null.

O chamador não tem a permissão necessária para acessar sourceDirectory'.

sourceDirectory’ contains invalid characters such as “, <, >, or |.

O caminho especificado, o nome de 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 de arquivo devem ser menores de 260 caracteres.

sourceDirectory’ stands for a file, not for a directory.

`CreateEntries(DiretórioInfo, Bool)`

Adicione ao arquivo todos os arquivos e diretórios repetidamente no diretório dado.

public CpioArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

`Parameters`

directory DirectoryInfo

Diretório para compressão.

includeRootDirectory bool

Indica se incluir o diretório de raiz ou não.

`Returns`

Introdução à instância.

`Examples`

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(cpioFile);
    }
}

`Exceptions`

directory’ is null.

O chamador não tem a permissão necessária para aceder ao directory”.

directory’ stands for a file, not for a directory.

`CreateEntry(Título: FileInfo, Bool)`

Crie uma única entrada dentro do arquivo.

public CpioEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

`Parameters`

name string

O nome da entrada.

fileInfo FileInfo

Os metadados do arquivo ou folha para ser comprimido.

openImmediately bool

É verdade, se abrir o arquivo imediatamente, caso contrário, abrir o arquivo em arquivo de armazenamento.

`Returns`

CpioEntry

Introdução à instância.

`Examples`

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new CpioArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.cpio");
}

`Remarks`

Se o arquivo for aberto imediatamente com o parâmetro, ele será bloqueado até que o arquivo seja apagado.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(Título: String, String, Bool)`

Crie uma única entrada dentro do arquivo.

public CpioEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)

`Parameters`

name string

O nome da entrada.

sourcePath string

O caminho para o arquivo ser comprimido.

openImmediately bool

É verdade, se abrir o arquivo imediatamente, caso contrário, abrir o arquivo em arquivo de armazenamento.

`Returns`

CpioEntry

Introdução à instância.

`Examples`

using (var archive = new CpioArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.cpio");
}

`Remarks`

O nome de entrada é definido apenas dentro do parâmetro.O nome de arquivo fornecido no parâmetro não afeta o nome de entrada.

Se o arquivo for aberto imediatamente com o parâmetro, ele será bloqueado até que o arquivo seja apagado.

`Exceptions`

sourcePath’ is null.

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

UnauthorizedAccessException

O sourcePath’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos. - ou - Nome do arquivo, como parte do name’, excede 100 símbolos.

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. - ou - name’ é demasiado longo para cpio.

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

`CreateEntry(Remoção, Stream)`

Crie uma única entrada dentro do arquivo.

public CpioEntry CreateEntry(string name, Stream source)

`Parameters`

name string

O nome da entrada.

source Stream

O fluxo de entrada para a entrada.

`Returns`

CpioEntry

Introdução à instância.

`Examples`

using (var archive = new CpioArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.cpio");
}

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

`DeleteEntry(CpioEntry)`

Remove a primeira ocorrência de uma entrada específica da lista de entrada.

public CpioArchive DeleteEntry(CpioEntry entry)

`Parameters`

entry CpioEntry

A entrada para remover da lista de entradas.

`Returns`

Introdução à instância.

`Examples`

Aqui está como você pode remover todas as entradas exceto a última:

using (var archive = new CpioArchive("archive.cpio"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputCpioFile);
}

`Exceptions`

entry’ is null.

`DeleteEntry(Int)`

Remova a entrada da lista de entrada por índice.

public CpioArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

O índice baseado em zero da entrada a ser removido.

`Returns`

ArgumentOutOfRangeException

O arquivo com a entrada foi apagado.

`Examples`

using (var archive = new CpioArchive("two_files.cpio"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.cpio");
}

`Exceptions`

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

`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.

`ExtractToDirectory(Redação)`

Extrair todos os arquivos 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.

`Examples`

using (var archive = new CpioArchive("archive.cpio")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

`Remarks`

Se o diretório não existe, será criado.

`Exceptions`

O caminho é zero

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, um caminho contém um caráter colon (:) que não faz parte de uma etiqueta de disco (“C:”).

Path é uma linha de comprimento zero, contém apenas espaço branco, ou contém um ou mais caracteres invalidos. Você pode pesquisar por caracteres invalidos usando o método System.IO.Path.GetInvalidPathChars. -or- Path é prefixado com, ou contém, apenas um caracter colon (:).

O diretório especificado pelo caminho é um arquivo. -or- O nome da rede não é conhecido.

`Save(Título: CpioFormat)`

Salve arquivo para um arquivo de destino fornecido.

public void Save(string destinationFileName, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

destinationFileName string

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

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (var archive = new CpioArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("archive.cpio");
}

`Remarks`

É possível salvar um arquivo no mesmo caminho que foi carregado. no entanto, isso não é recomendado porque esta abordagem usa a cópia para um arquivo temporário.

`Exceptions`

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

destinationFileName’ is null.

DirectoryNotFoundException

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.

A destinationFileName’ especificada é invalida (por exemplo, está em um disco não mapeado).

UnauthorizedAccessException

Um erro I/O ocorreu ao abrir o arquivo.

destinationFileName’Specified a file is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.

destinationFileName’ is in an invalid format.

`Save(Remoção, CpioFormat)`

Salve arquivo para o fluxo fornecido.

public void Save(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

fluxo de destino.

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(cpioFile);
    }
}

`Remarks`

Tem que ser escrita.

`Exceptions`

output’ is null.

output’ is not writable. - or - output’ is the same stream we extract from.- OR -It is impossible to save archive in cpioFormat’ due to format restrictions.

`SaveGzipped(Remoção, CpioFormat)`

Salve arquivos para o fluxo com compressão gzip.

public void SaveGzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

fluxo de destino.

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

`Remarks`

Tem que ser escrita.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveGzipped(Título: CpioFormat)`

Salve arquivos para o arquivo por caminho com compressão gzip.

public void SaveGzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.cpio.gz");
    }
}

`Salvação compressada(Remoção, CpioFormat)`

Salve o arquivo para o fluxo com a compressão LZMA.

public void SaveLZMACompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

fluxo de destino.

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

`Remarks`

Tem que ser escrita.

Importante: o arquivo cpio é composto e então comprimido dentro deste método, seu conteúdo é mantido internamente.

`Salvação compressada(Título: CpioFormat)`

Salve o arquivo para o arquivo por caminho com a compressão lzma.

public void SaveLZMACompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.cpio.lzma");
    }
}

`Remarks`

Importante: o arquivo cpio é composto e então comprimido dentro deste método, seu conteúdo é mantido internamente.

`SaveLzipped(Remoção, CpioFormat)`

Salve arquivos para o fluxo com compressão lzip.

public void SaveLzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

fluxo de destino.

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

`Remarks`

Tem que ser escrita.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveLzipped(Título: CpioFormat)`

Salve arquivos para o arquivo por caminho com compressão lzip.

public void SaveLzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.cpio.lz");
    }
}

`SaveXzCompressed(Stream, CpioFormat, XzArchiveSettings)`

Salve arquivo para o fluxo com compressão xz.

public void SaveXzCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)

`Parameters`

output Stream

fluxo de destino.

cpioFormat CpioFormat

Defina o formato de cpio header.

settings XzArchiveSettings

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

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

`Remarks`

O fluxo deve ser escrito.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveXzCompressed(Arquivos, CpioFormat, XzArchiveSettings)`

Salve arquivos para o caminho por caminho com compressão xz.

public void SaveXzCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)

`Parameters`

path string

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

cpioFormat CpioFormat

Defina o formato de cpio header.

settings XzArchiveSettings

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

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.cpio.xz");
    }
}

`SaudaçãoCompressão(Remoção, CpioFormat)`

Salve arquivo para o fluxo com compressão Z.

public void SaveZCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

fluxo de destino.

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

`Remarks`

Tem que ser escrita.

`Exceptions`

output’ is null.

output’ is not writable.

`SaudaçãoCompressão(Título: CpioFormat)`

Salve arquivos para o caminho por caminho com compressão Z.

public void SaveZCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.cpio.Z");
    }
}

`SaveZstandard(Remoção, CpioFormat)`

Salve arquivo para o fluxo com compressão padrão.

public void SaveZstandard(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

fluxo de destino.

cpioFormat CpioFormat

Defina o formato de cpio header.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

`Remarks`

Tem que ser escrita.

`Exceptions`

output’ is null.