Class CpioArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid cpio archive.

`CpioArchive(El string)`

Inicia una nueva instancia de la clase Aspose.Zip.Cpio.CpioArchive y compone una lista de entradas que se puede extraer del archivo.

public CpioArchive(string path)

`Parameters`

path string

El camino hacia el archivo.

`Examples`

El siguiente ejemplo muestra cómo extraer todas las entradas a un directorio.

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

`Remarks`

Este constructor no desembala ninguna entrada. Ver Aspose.Zip.Cpio.CpioEntry.Método abierto para desembala.

`Exceptions`

path’ is null.

El solicitante no tiene la autorización necesaria para acceder.

UnauthorizedAccessException

El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.

Se denega el acceso al archivo path.

La ruta path", nombre de archivo, o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres, y los nombres de archivo deben ser menos de 260 caracteres.

DirectoryNotFoundException

El archivo en path’ contiene una columna (:) en el medio de la línea.

FileNotFoundException

El archivo no se encuentra.

La ruta especificada es invalida, como estar en un disco no mapeado.

El archivo ya está abierto.

`Properties`

`Entries`

Obtiene entradas del tipo Aspose.Zip.Cpio.CpioEntry que constituye el archivo.

public ReadOnlyCollection<cpioentry> Entries { get; }

`Valor de la propiedad`

ReadOnlyCollection &ylt; CpioEntry >

`Methods`

`CreateEntries(Cortesía, Bool)`

Ads al archivo todos los archivos y directorios recurrentemente en el directorio dado.

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

`Parameters`

sourceDirectory string

Directorios para compresión.

includeRootDirectory bool

Indica si incluir el directorio de raíz mismo o no.

`Returns`

Introducción de la instancia.

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

El llamador no tiene el permiso necesario para acceder a sourceDirectory'.

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

El camino especificado, el nombre de archivo, o ambos excede la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres y los nombres de archivo deben ser menos de 260 caracteres.

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

`CreateEntries(Siguiente Entrada siguiente: Bool)`

Ads al archivo todos los archivos y directorios recurrentemente en el directorio dado.

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

`Parameters`

directory DirectoryInfo

Directorios para compresión.

includeRootDirectory bool

Indica si incluir el directorio de raíz mismo o no.

`Returns`

Introducción de la instancia.

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

El llamador no tiene el permiso necesario para acceder a la directory'.

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

`CreateEntry(Archivo de la etiqueta: FileInfo, Bool)`

Crea una entrada única dentro del archivo.

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

`Parameters`

name string

El nombre de la entrada.

fileInfo FileInfo

Los metadatos del archivo o de la carpeta para ser comprimido.

openImmediately bool

Es cierto, si se abre el archivo de inmediato, de lo contrario se abre el archivo en el archivo de almacenamiento.

`Returns`

CpioEntry

Introducción de la instancia.

`Examples`

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

`Remarks`

Si el archivo se abre inmediatamente con el parámetro se bloquea hasta que el archivo se apaga.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(Síntomas, Síntomas y Bool)`

Crea una entrada única dentro del archivo.

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

`Parameters`

name string

El nombre de la entrada.

sourcePath string

El camino para que el archivo sea comprimido.

openImmediately bool

Es cierto, si se abre el archivo de inmediato, de lo contrario se abre el archivo en el archivo de almacenamiento.

`Returns`

CpioEntry

Introducción de la instancia.

`Examples`

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

`Remarks`

El nombre de entrada se establece únicamente dentro del parámetro.El nombre de archivo proporcionado en el parámetro no afecta al nombre de entrada.

Si el archivo se abre inmediatamente con el parámetro se bloquea hasta que el archivo se apaga.

`Exceptions`

sourcePath’ is null.

El solicitante no tiene la autorización necesaria para acceder.

UnauthorizedAccessException

El sourcePath’ es vacío, contiene sólo espacios blancos, o contiene caracteres invalidos. - o - Nombre de archivo, como parte del name’, supera los 100 símbolos.

El acceso al archivo sourcePath’ se denega.

La sourcePath’, nombre de archivo, o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres, y los nombres de archivo deben ser menos de 260 caracteres. - o - name’ es demasiado largo para cpio.

El archivo en sourcePath’ contiene una columna (:) en el medio de la línea.

`CreateEntry(El Stream, el Stream)`

Crea una entrada única dentro del archivo.

public CpioEntry CreateEntry(string name, Stream source)

`Parameters`

name string

El nombre de la entrada.

source Stream

El flujo de entrada para la entrada.

`Returns`

CpioEntry

Introducción de la instancia.

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

Elimina la primera aparición de una entrada específica de la lista de entrada.

public CpioArchive DeleteEntry(CpioEntry entry)

`Parameters`

entry CpioEntry

La entrada a eliminar de la lista de entradas.

`Returns`

Introducción de la instancia.

`Examples`

Aquí está cómo puedes eliminar todas las entradas excepto la ú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)`

Elimina la entrada de la lista de entrada por índice.

public CpioArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

El índice basado en cero de la entrada a eliminar.

`Returns`

ArgumentOutOfRangeException

El archivo con la entrada fue eliminado.

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

Desempeña tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no gestionados.

public void Dispose()

`Dispose(BOOL)`

Desempeña tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no gestionados.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Los recursos gestionados deben ser eliminados.

`ExtractToDirectory(El string)`

Extracta todos los archivos en el directorio proporcionado.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

El camino hacia el directorio para colocar los archivos extraídos.

`Examples`

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

`Remarks`

Si el directorio no existe, se crear.

`Exceptions`

El camino es nulo

Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres y los nombres de archivo deben ser menos de 260 caracteres.

El llamador no tiene el permiso necesario para acceder al directorio existente.

Si el directorio no existe, un camino contiene un carácter colon (:) que no forma parte de una etiqueta de disco (“C:”).

Path es una línea de longitud cero, contiene sólo espacio blanco, o contiene uno o más caracteres invalidos.Puede solicitar caracteres invalidos utilizando el método System.IO.Path.GetInvalidPathChars. -o- Path es prefixado con, o contiene, sólo un caracter colon (:).

El directorio especificado por ruta es un archivo. -o- El nombre de red no es conocido.

`Save(Síntomas, CpioFormat)`

Salva archivo a un archivo de destino proporcionado.

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

`Parameters`

destinationFileName string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

cpioFormat CpioFormat

Definición del formato de cpio header.

`Examples`

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

`Remarks`

Es posible guardar un archivo en el mismo camino que fue cargado de. sin embargo, esto no se recomienda porque este enfoque utiliza la copia a un archivo temporal.

`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

La destinationFileName’, nombre de archivo, o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres, y los nombres de archivo deben ser menos de 260 caracteres.

La destinationFileName” especificada es invalida (por ejemplo, se encuentra en un disco no mapeado).

UnauthorizedAccessException

Un error I/O ocurrió al abrir el archivo.

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(El flujo, CpioFormat)`

Salva archivos a la corriente proporcionada.

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

`Parameters`

output Stream

El flujo de destino.

cpioFormat CpioFormat

Definición del 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`

Debe ser escrito.

`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(El flujo, CpioFormat)`

Salva archivos a la corriente con la composición gzip.

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

`Parameters`

output Stream

El flujo de destino.

cpioFormat CpioFormat

Definición del 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`

Debe ser escrito.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveGzipped(Síntomas, CpioFormat)`

Salva archivos al archivo por vía con la composición gzip.

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

`Parameters`

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

cpioFormat CpioFormat

Definición del 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");
    }
}

`Salvación compresada(El flujo, CpioFormat)`

Salva el archivo al flujo con la compresión LZMA.

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

`Parameters`

output Stream

El flujo de destino.

cpioFormat CpioFormat

Definición del 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`

Debe ser escrito.

Importante: el archivo cpio se compone y luego se comprime dentro de este método, su contenido se mantiene internamente.

`Salvación compresada(Síntomas, CpioFormat)`

Salva el archivo al archivo por vía con la compresión lzma.

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

`Parameters`

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

cpioFormat CpioFormat

Definición del 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: el archivo cpio se compone y luego se comprime dentro de este método, su contenido se mantiene internamente.

`SaveLzipped(El flujo, CpioFormat)`

Salva archivos a la corriente con la compresión lzip.

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

`Parameters`

output Stream

El flujo de destino.

cpioFormat CpioFormat

Definición del 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`

Debe ser escrito.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveLzipped(Síntomas, CpioFormat)`

Salva archivo al archivo por vía con la compresión lzip.

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

`Parameters`

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

cpioFormat CpioFormat

Definición del 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(Siguiente Entrada siguiente: CpioFormat, XzArchiveSettings)`

Salva archivos a la corriente con la composición xz.

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

`Parameters`

output Stream

El flujo de destino.

cpioFormat CpioFormat

Definición del formato de cpio header.

settings XzArchiveSettings

Set de configuración específica xz archivo: tamaño diccionario, tamaño de bloque, tipo de verificación.

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

El flujo debe ser escrito.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveXzCompressed(Tamaño, CpioFormat, XzArchiveSettings)`

Salva archivo al camino por camino con la composición xz.

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

`Parameters`

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

cpioFormat CpioFormat

Definición del formato de cpio header.

settings XzArchiveSettings

Set de configuración específica xz archivo: tamaño diccionario, tamaño de bloque, tipo de verificación.

`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");
    }
}

`SalvaciónCompreso(El flujo, CpioFormat)`

Salva archivos a la corriente con la composición Z.

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

`Parameters`

output Stream

El flujo de destino.

cpioFormat CpioFormat

Definición del 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`

Debe ser escrito.

`Exceptions`

output’ is null.

output’ is not writable.

`SalvaciónCompreso(Síntomas, CpioFormat)`

Salva archivos al camino por camino con la compresión Z.

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

`Parameters`

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

cpioFormat CpioFormat

Definición del 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(El flujo, CpioFormat)`

Salva archivos a la corriente con la composición Zstandard.

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

`Parameters`

output Stream

El flujo de destino.

cpioFormat CpioFormat

Definición del 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`

Debe ser escrito.

`Exceptions`

output’ is null.