Class CpioArchive

Class CpioArchive

Le nom : Aspose.Zip.Cpio Assemblée: Aspose.Zip.dll (25.5.0)

Questa classe rappresenta il file di archivio cpio.

public class CpioArchive : IArchive, IDisposable

Inheritance

object CpioArchive

Implements

IArchive , IDisposable

I membri ereditari

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

Constructors

CpioArchive()

Inizializza una nuova instanza della classe Aspose.Zip.Cpio.CpioArchive.

public CpioArchive()

Examples

Il seguente esempio mostra come comprimere un file.

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

CpioArchive(Stream)

Inizia una nuova instanza della classe Aspose.Zip.Cpio.CpioArchive e compone un elenco di entrate che può essere estratto dall’archivio.

public CpioArchive(Stream sourceStream)

Parameters

sourceStream Stream

La fonte dell’archivio. deve essere ricercabile.

Examples

L’esempio seguente mostra come estrarre tutte le entrate in un directory.

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

Remarks

Questo costruttore non spazzatura nessun ingresso. vedi Aspose.Zip.Cpio.CpioEntry.Open metodo per spazzatura.

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid cpio archive.

CpioArchive(Le string)

Inizia una nuova instanza della classe Aspose.Zip.Cpio.CpioArchive e compone un elenco di entrate che può essere estratto dall’archivio.

public CpioArchive(string path)

Parameters

path string

Il percorso verso l’archivio.

Examples

L’esempio seguente mostra come estrarre tutte le entrate in un directory.

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

Remarks

Questo costruttore non spazzatura nessun ingresso. vedi Aspose.Zip.Cpio.CpioEntry.Open metodo per spazzatura.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Il file in path’ contiene una colonna (:) nel mezzo della riga.

FileNotFoundException

Il file non è trovato.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

IOException

Il file è già aperto.

Properties

Entries

Riceve le entrate del tipo Aspose.Zip.Cpio.CpioEntry che costituisce l’archivio.

public ReadOnlyCollection<cpioentry> Entries { get; }

Valore di proprietà

ReadOnlyCollection di < CpioEntry >

Methods

CreateEntries(Télécharger, Bool)

Aggiungi all’archivio tutti i file e i directory recursivamente nel directory dato.

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

Parameters

sourceDirectory string

Direttore per la compressione.

includeRootDirectory bool

Indica se includere lo stesso directory root o meno.

Returns

CpioArchive

L’istanza di ingresso Cpio.

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

Il chiamante non ha il permesso richiesto per accedere a sourceDirectory'.

ArgumentException

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

PathTooLongException

Il percorso specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

IOException

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

CreateEntries(Résumé : Bool)

Aggiungi all’archivio tutti i file e i directory recursivamente nel directory dato.

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

Parameters

directory DirectoryInfo

Direttore per la compressione.

includeRootDirectory bool

Indica se includere lo stesso directory root o meno.

Returns

CpioArchive

L’istanza di ingresso Cpio.

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

Il chiamante non ha il permesso richiesto per accedere alla directory”.

IOException

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

CreateEntry(Téléchargement, FileInfo, Bool)

Creare un singolo ingresso all’interno dell’archivio.

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

Parameters

name string

Il nome dell’ingresso.

fileInfo FileInfo

I metadati del file o della cartella da comprimere.

openImmediately bool

È vero, se si apre immediatamente il file, altrimenti si apre il file su archivio di archiviazione.

Returns

CpioEntry

L’istanza di ingresso Cpio.

Examples

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

Remarks

Si le fichier est ouvert immédiatement avec le paramètre, il est bloqué jusqu’à ce que l’archive soit éliminée.

Exceptions

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(String, String et Bool)

Creare un singolo ingresso all’interno dell’archivio.

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

Parameters

name string

Il nome dell’ingresso.

sourcePath string

Il modo in cui il file viene compreso.

openImmediately bool

È vero, se si apre immediatamente il file, altrimenti si apre il file su archivio di archiviazione.

Returns

CpioEntry

L’istanza di ingresso Cpio.

Examples

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

Remarks

Le nom de fichier fourni dans le paramètre n’affecte pas le nom de fichier.

Si le fichier est ouvert immédiatement avec le paramètre, il est bloqué jusqu’à ce que l’archive soit éliminée.

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

Il sourcePath’ è vuoto, contiene solo spazi bianchi, o contiene caratteri invalidi. - o - Nome del file, come parte del name’, supera i 100 simboli.

UnauthorizedAccessException

L’accesso al file sourcePath’ è negato.

PathTooLongException

Per esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi dei file devono essere meno di 260 caratteri. - o - name’ è troppo lungo per cpio.

NotSupportedException

Il file in sourcePath’ contiene una colonna (:) nel mezzo della riga.

CreateEntry(Téléchargement, Stream)

Creare un singolo ingresso all’interno dell’archivio.

public CpioEntry CreateEntry(string name, Stream source)

Parameters

name string

Il nome dell’ingresso.

source Stream

Il flusso di ingresso per l’ingresso.

Returns

CpioEntry

L’istanza di ingresso Cpio.

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)

Rimuove la prima comparsa di un’entrata specifica dall’elenco delle entrate.

public CpioArchive DeleteEntry(CpioEntry entry)

Parameters

entry CpioEntry

L’ingresso da rimuovere dall’elenco delle entrate.

Returns

CpioArchive

L’istanza di ingresso Cpio.

Examples

Ecco come puoi rimuovere tutte le entrate tranne l’ultima:

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)

Rimuovere l’ingresso dalla lista di ingressi per indice.

public CpioArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

L’indice basato su zero dell’ingresso da rimuovere.

Returns

CpioArchive

L’archivio con l’ingresso è stato cancellato.

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

Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.

public void Dispose()

Dispose(Boulée)

Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Le risorse gestite dovrebbero essere sprecate.

ExtractToDirectory(Le string)

Estratta tutti i file nell’archivio nel directory fornito.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Il percorso verso il directory per posizionare i file estratti.

Examples

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

Remarks

Se il directory non esiste, sarà creato.

Exceptions

ArgumentNullException

Il percorso è zero

PathTooLongException

Il percorso specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.

SecurityException

Il chiamante non ha il permesso richiesto per accedere al directory esistente.

NotSupportedException

Si le catalogue n’existe pas, une voie contient un caractère colon (:) qui n’est pas partie d’une étiquette de disque (“C:”).

ArgumentException

Il percorso è una riga di lunghezza zero, contiene solo spazio bianco, o contiene uno o più caratteri invalidi. Puoi chiedere caratteri invalidi utilizzando il metodo System.IO.Path.GetInvalidPathChars. -o- percorso è prefinito con, o contiene, solo un carattere colonico (:).

IOException

Il directory specificato per percorso è un file. -or- Il nome della rete non è noto.

Save(Télécharger, CpioFormat)

Salva archivio a un file di destinazione fornito.

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

Parameters

destinationFileName string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

cpioFormat CpioFormat

Definisce il formato cpio header.

Examples

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

Remarks

È possibile salvare un archivio nello stesso percorso dal quale è stato caricato. tuttavia, questo non è raccomandato perché questo approccio utilizza la copia a un file temporaneo.

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 specifica destinationFileName’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.

DirectoryNotFoundException

La specifica destinationFileName’ è invalida (ad esempio, si trova su un disco non mappato).

IOException

Un errore I/O si è verificato durante l’apertura del file.

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(Résumé : CpioFormat)

Salva archivio al flusso fornito.

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

Parameters

output Stream

Il flusso di destinazione.

cpioFormat CpioFormat

Definisce il formato 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

doit être écrite.

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(Résumé : CpioFormat)

Salva archivi al flusso con la compressione gzip.

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

Parameters

output Stream

Il flusso di destinazione.

cpioFormat CpioFormat

Definisce il formato 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

doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Télécharger, CpioFormat)

Salva l’archivio al file per via con la compressione gzip.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

cpioFormat CpioFormat

Definisce il formato 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");
    }
}

Réservation compresse(Résumé : CpioFormat)

Salva l’archivio al flusso con la compressione LZMA.

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

Parameters

output Stream

Il flusso di destinazione.

cpioFormat CpioFormat

Definisce il formato 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

doit être écrite.

Importante: l’archivio cpio viene compostato e quindi compreso all’interno di questo metodo, il suo contenuto viene conservato internamente.

Réservation compresse(Télécharger, CpioFormat)

Salva l’archivio per il file con lzma compressione.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

cpioFormat CpioFormat

Definisce il formato 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: l’archivio cpio viene compostato e quindi compreso all’interno di questo metodo, il suo contenuto viene conservato internamente.

SaveLzipped(Résumé : CpioFormat)

Salva archivi al flusso con la compressione lzip.

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

Parameters

output Stream

Il flusso di destinazione.

cpioFormat CpioFormat

Definisce il formato 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

doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Télécharger, CpioFormat)

Salva l’archivio al file per via con la compressione lzip.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

cpioFormat CpioFormat

Definisce il formato 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)

Salva archivio al flusso con la compressione xz.

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

Parameters

output Stream

Il flusso di destinazione.

cpioFormat CpioFormat

Definisce il formato cpio header.

settings XzArchiveSettings

Set di impostazioni specifici xz archivio: dimensione del dizionario, dimensione del blocco, tipo di controllo.

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

Le flux doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(Sujet, CpioFormat, XzArchiveSettings)

Salva l’archivio per strada con la compressione xz.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

cpioFormat CpioFormat

Definisce il formato cpio header.

settings XzArchiveSettings

Set di impostazioni specifici xz archivio: dimensione del dizionario, dimensione del blocco, tipo di controllo.

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

RésuméComprimé(Résumé : CpioFormat)

Salva archivio al flusso con la compressione Z.

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

Parameters

output Stream

Il flusso di destinazione.

cpioFormat CpioFormat

Definisce il formato 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

doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

RésuméComprimé(Télécharger, CpioFormat)

Salva l’archivio per strada con la compressione Z.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

cpioFormat CpioFormat

Definisce il formato 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(Résumé : CpioFormat)

Salva archivio al flusso con la compressione Zstandard.

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

Parameters

output Stream

Il flusso di destinazione.

cpioFormat CpioFormat

Definisce il formato 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

doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Télécharger, CpioFormat)

Salva l’archivio al file per strada con la compressione standard.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

cpioFormat CpioFormat

Definisce il formato 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");
    }
}
 Français