Class CpioArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid cpio archive.

`CpioArchive(Tàrrega)`

Inicialitza una nova instància de la classe Aspose.Zip.Cpio.CpioArxiu i componeix una llista d’entrada que es pot extreure de l’arxiu.

public CpioArchive(string path)

`Parameters`

path string

El camí cap a l’arxiu.

`Examples`

L’exemple següent mostra com extreure totes les entrades a un directori.

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

`Remarks`

Aquest constructor no desembalca cap entrada. Veure Aspose.Zip.Cpio.CpioEntry.Open mètode per desembalcar.

`Exceptions`

path’ is null.

El client no té el permís d’accés requerit.

UnauthorizedAccessException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

L’accés al fitxer path" es nega.

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

DirectoryNotFoundException

El fitxer a path’ conté una columna (:) al mig de la cadena.

FileNotFoundException

El fitxer no es troba.

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

El fitxer ja està obert.

`Properties`

`Entries`

Obté entrades del tipus Aspose.Zip.Cpio.CpioEntry que constitueix l’arxiu.

public ReadOnlyCollection<cpioentry> Entries { get; }

`Valor de la propietat`

ReadOnlyCollection < CpioEntry >

`Methods`

`CreateEntries(Tàrrega, Bool)`

Afegeix a l’arxiu tots els arxius i directoris recursivament en el directori donat.

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

`Parameters`

sourceDirectory string

Direcció per a la compressi.

includeRootDirectory bool

Indica si incloure o no la pròpia direcció de les arrels.

`Returns`

Introducció de l’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.

El convocador no té el permís requerit per accedir a sourceDirectory'.

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

Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxers han de ser menys de 260 caràcters.

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

`CreateEntries(DireccióInfo, Bool)`

Afegeix a l’arxiu tots els arxius i directoris recursivament en el directori donat.

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

`Parameters`

directory DirectoryInfo

Direcció per a la compressi.

includeRootDirectory bool

Indica si incloure o no la pròpia direcció de les arrels.

`Returns`

Introducció de l’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.

El convocador no té el permís requerit per accedir a la direcció directory'.

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

`CreateEntry(Arxiu, FileInfo, Bool)`

Crear una entrada única dins de l’arxiu.

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

`Parameters`

name string

El nom de l’entrada.

fileInfo FileInfo

Els metadats del fitxer o de la carpeta per a ser comprès.

openImmediately bool

s cert, si obre el fitxer immediatament, d’altra banda obre el fitxer en l’arxiu d’emmagatzematge.

`Returns`

CpioEntry

Introducció de l’instància.

`Examples`

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

`Remarks`

Si el fitxer s’obre immediatament amb el paràmetre es bloqueja fins que l’arxiu s’elimina.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(Tècnic, Tècnic, Tècnic)`

Crear una entrada única dins de l’arxiu.

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

`Parameters`

name string

El nom de l’entrada.

sourcePath string

El camí per a arxiu per a ser comprès.

openImmediately bool

s cert, si obre el fitxer immediatament, d’altra banda obre el fitxer en l’arxiu d’emmagatzematge.

`Returns`

CpioEntry

Introducció de l’instància.

`Examples`

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

`Remarks`

El nom d’entrada s’estableix únicament dins del paràmetre.El nom de fitxer proporcionat en el paràmetre no afecta el nom d’entrada.

Si el fitxer s’obre immediatament amb el paràmetre es bloqueja fins que l’arxiu s’elimina.

`Exceptions`

sourcePath’ is null.

El client no té el permís d’accés requerit.

UnauthorizedAccessException

El sourcePath’ és buit, només conté espais blancs, o conté caràcters invalidats. - o - Nom de fitxer, com a part del name’, supera els 100 símbols.

L’accés al fitxer sourcePath’ es nega.

Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxers han de ser menys de 260 caràcters. - o - name’ és massa llarg per a cpio.

El fitxer a sourcePath’ conté una columna (:) al mig de la cadena.

`CreateEntry(Tàrrega, Tàrrega)`

Crear una entrada única dins de l’arxiu.

public CpioEntry CreateEntry(string name, Stream source)

`Parameters`

name string

El nom de l’entrada.

source Stream

El flux d’entrada per a l’entrada.

`Returns`

CpioEntry

Introducció de l’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)`

Elimina la primera aparició d’una entrada específica de la llista d’entrada.

public CpioArchive DeleteEntry(CpioEntry entry)

`Parameters`

entry CpioEntry

L’entrada per eliminar de la llista d’entrada.

`Returns`

Introducció de l’instància.

`Examples`

A continuació podeu eliminar totes les entrades excepte les últimes:

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 l’entrada de la llista d’entrada per index.

public CpioArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

L’índex basat en zero de l’entrada a eliminar.

`Returns`

ArgumentOutOfRangeException

L’arxiu amb la entrada es va eliminar.

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

Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.

public void Dispose()

`Dispose(La botiga)`

Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

S’han de disposar de recursos gestionats.

`ExtractToDirectory(Tàrrega)`

Extrata tots els arxius de l’arxiu a la direcció proporcionada.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

El camí a la direcció per col·locar els arxius extraïts.

`Examples`

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

`Remarks`

Si la direcció no existeix, es crear.

`Exceptions`

El camí és zero

Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters i els noms de fitxers han de ser menys de 260 caràcters.

El sol·licitant no té l’autorització necessària per accedir a la direcció existent.

Si la direcció no existeix, un recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“C:”).

Path és una sèrie de longitud zero, només conté espai blanc, o conté un o més caràcters invalids. Podeu sol·licitar caràcters invalids utilitzant el mètode System.IO.Path.GetInvalidPathChars. -o- el camí està prefixat amb, o conté, només un caràcter colon (:).

El directori especificat per ruta és un arxiu. -o- El nom de la xarxa no és conegut.

`Save(Tàrrega, CpioFormat)`

Salva l’arxiu a un arxiu de destinació proporcionat.

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

`Parameters`

destinationFileName string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

cpioFormat CpioFormat

Defineix el format de cpio header.

`Examples`

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

`Remarks`

s possible guardar un arxiu al mateix camí que es va carregar des. No obstant això, això no es recomana perquè aquest enfocament utilitza la còpia a un arxiu 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

El nom de fitxer especificat destinationFileName, o ambdós superen la longitud màxima definida pel sistema. Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

La destinació especificada FileName’ és invalidada (per exemple, es troba en un disc no mapeat).

UnauthorizedAccessException

Un error I/O es va produir durant l’obertura del fitxer.

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

Salva l’arxiu al corrent proporcionat.

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

`Parameters`

output Stream

El flux de destinaci.

cpioFormat CpioFormat

Defineix el format 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`

Ha de ser escriïble.

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

Salva l’arxiu al corrent amb la compressió gzip.

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

`Parameters`

output Stream

El flux de destinaci.

cpioFormat CpioFormat

Defineix el format 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`

Ha de ser escriïble.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveGzipped(Tàrrega, CpioFormat)`

Salva l’arxiu al fitxer per camí amb la compressió gzip.

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

`Parameters`

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

cpioFormat CpioFormat

Defineix el format 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");
    }
}

`Compressió de salvatge(Llistat, CpioFormat)`

Salva l’arxiu al corrent amb la compressió LZMA.

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

`Parameters`

output Stream

El flux de destinaci.

cpioFormat CpioFormat

Defineix el format 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`

Ha de ser escriïble.

Important: l’arxiu cpio es componeix i després es comprimeix dins d’aquest mètode, el seu contingut es conserva internament.

`Compressió de salvatge(Tàrrega, CpioFormat)`

Salva l’arxiu al fitxer per camí amb la compressió lzma.

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

`Parameters`

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

cpioFormat CpioFormat

Defineix el format 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`

Important: l’arxiu cpio es componeix i després es comprimeix dins d’aquest mètode, el seu contingut es conserva internament.

`SaveLzipped(Llistat, CpioFormat)`

Salva l’arxiu al corrent amb la compressió lzip.

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

`Parameters`

output Stream

El flux de destinaci.

cpioFormat CpioFormat

Defineix el format 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`

Ha de ser escriïble.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveLzipped(Tàrrega, CpioFormat)`

Salva l’arxiu al fitxer per camí amb la compressió lzip.

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

`Parameters`

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

cpioFormat CpioFormat

Defineix el format 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(Guió, CpioFormat, XzArchiveSettings)`

Salva l’arxiu al corrent amb xz compressi.

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

`Parameters`

output Stream

El flux de destinaci.

cpioFormat CpioFormat

Defineix el format de cpio header.

settings XzArchiveSettings

Set de configuració específic xz arxiu: mida del diccionari, mida del bloc, tipus de comprovaci.

`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 flux ha de ser escrit.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveXzCompressed(Llistat, CpioFormat, XzArchiveSettings)`

Salva l’arxiu al camí per camí amb xz compressi.

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

`Parameters`

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

cpioFormat CpioFormat

Defineix el format de cpio header.

settings XzArchiveSettings

Set de configuració específic xz arxiu: mida del diccionari, mida del bloc, tipus de comprovaci.

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

`Compressió(Llistat, CpioFormat)`

Salva l’arxiu al corrent amb la compressió Z.

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

`Parameters`

output Stream

El flux de destinaci.

cpioFormat CpioFormat

Defineix el format 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`

Ha de ser escriïble.

`Exceptions`

output’ is null.

output’ is not writable.

`Compressió(Tàrrega, CpioFormat)`

Salva l’arxiu al camí per camí amb la compressió Z.

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

`Parameters`

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

cpioFormat CpioFormat

Defineix el format 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(Llistat, CpioFormat)`

Salva l’arxiu al corrent amb la compressió Zstandard.

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

`Parameters`

output Stream

El flux de destinaci.

cpioFormat CpioFormat

Defineix el format 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`

Ha de ser escriïble.

`Exceptions`

output’ is null.