Class CpioArchive

Class CpioArchive

Nombre del espacio: Aspose.Zip.Cpio Asamblea: Aspose.Zip.dll (25.5.0)

Esta clase representa el archivo cpio.

public class CpioArchive : IArchive, IDisposable

Inheritance

object CpioArchive

Implements

IArchive ,y, IDisposable

Miembros heredados

object.GetType() ,y, object.MemberwiseClone() ,y, object.ToString() ,y, object.Equals(object?) ,y, object.Equals(object?, object?) ,y, object.ReferenceEquals(object?, object?) ,y, object.GetHashCode()

Constructors

CpioArchive()

Inicia una nueva instancia de la clase Aspose.Zip.Cpio.CpioArchive.

public CpioArchive()

Examples

El siguiente ejemplo muestra cómo comprimir un archivo.

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

CpioArchive(Stream)

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

Parameters

sourceStream Stream

La fuente del archivo. debe ser buscable.

Examples

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

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

Remarks

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

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

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

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

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.

NotSupportedException

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

FileNotFoundException

El archivo no se encuentra.

DirectoryNotFoundException

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

IOException

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

CpioArchive

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

ArgumentNullException

sourceDirectory’ is null.

SecurityException

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

ArgumentException

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

PathTooLongException

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.

IOException

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

CpioArchive

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

ArgumentNullException

directory’ is null.

SecurityException

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

IOException

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

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

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

ArgumentNullException

sourcePath’ is null.

SecurityException

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

ArgumentException

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.

UnauthorizedAccessException

El acceso al archivo sourcePath’ se denega.

PathTooLongException

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.

NotSupportedException

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

ArgumentNullException

name’ is null.

ArgumentNullException

source’ is null.

ArgumentException

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

CpioArchive

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

ArgumentNullException

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

CpioArchive

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

ArgumentOutOfRangeException

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

ArgumentNullException

El camino es nulo

PathTooLongException

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.

SecurityException

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

NotSupportedException

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

ArgumentException

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 (:).

IOException

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

ArgumentException

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

ArgumentNullException

destinationFileName’ is null.

PathTooLongException

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.

DirectoryNotFoundException

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

IOException

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

UnauthorizedAccessException

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.

NotSupportedException

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

ArgumentNullException

output’ is null.

ArgumentException

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

ArgumentNullException

output’ is null.

ArgumentException

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

ArgumentNullException

output’ is null.

ArgumentException

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

ArgumentNullException

output’ is null.

ArgumentException

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

ArgumentNullException

output’ is null.

ArgumentException

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

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Síntomas, CpioFormat)

Salva archivos al archivo por camino con la compresión Zstandard.

public void SaveZstandard(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.SaveZstandard("result.cpio.zst");
    }
}
 Español