Class CpioArchive

sourceStream ist null.

sourceStream ist nicht durchsuchbar.

InvalidDataException

sourceStream ist kein gültiges cpio-Archiv.

CpioArchive(string)

Initialisiert eine neue Instanz der Aspose.Zip.Cpio.CpioArchive-Klasse und erstellt eine Liste von Einträgen, die aus dem Archiv extrahiert werden können.

public CpioArchive(string path)

Parameter

path string

Der Pfad zur Archivdatei.

Beispiele

Das folgende Beispiel zeigt, wie man alle Einträge in ein Verzeichnis extrahiert.

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

Anmerkungen

Dieser Konstruktor entpackt keinen Eintrag. Siehe die Methode Aspose.Zip.Cpio.CpioEntry.Open zum Entpacken.

Ausnahmen

path ist null.

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.

UnauthorizedAccessException

Der path ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.

Der Zugriff auf die Datei path ist verweigert.

Der angegebene path, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.

DirectoryNotFoundException

Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.

FileNotFoundException

Die Datei wurde nicht gefunden.

Der angegebene Pfad ist ungültig, z. B. wenn er sich auf einem nicht zugeordneten Laufwerk befindet.

ReadOnlyCollection<CpioEntry>

Die Datei ist bereits geöffnet.

Eigenschaften

Entries

Erhält die Einträge des Typs Aspose.Zip.Cpio.CpioEntry, die das Archiv bilden.

public ReadOnlyCollection<cpioentry> Entries { get; }

Eigenschaftswert

Methoden

CreateEntries(string, bool)

Fügt dem Archiv alle Dateien und Verzeichnisse rekursiv im angegebenen Verzeichnis hinzu.

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

Parameter

sourceDirectory string

Verzeichnis zum Komprimieren.

includeRootDirectory bool

Gibt an, ob das Wurzelverzeichnis selbst einbezogen werden soll oder nicht.

Rückgabewert

Cpio-Eintrag-Instanz.

Beispiele

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

Ausnahmen

sourceDirectory ist null.

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff auf sourceDirectory.

sourceDirectory enthält ungültige Zeichen wie “, <, > oder |.

Der angegebene Pfad, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein. Der angegebene Pfad, Dateiname oder beides sind zu lang.

sourceDirectory steht für eine Datei, nicht für ein Verzeichnis.

CreateEntries(DirectoryInfo, bool)

Fügt dem Archiv alle Dateien und Verzeichnisse rekursiv im angegebenen Verzeichnis hinzu.

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

Parameter

directory DirectoryInfo

Verzeichnis zum Komprimieren.

includeRootDirectory bool

Gibt an, ob das Wurzelverzeichnis selbst einbezogen werden soll oder nicht.

Rückgabewert

Cpio-Eintrag-Instanz.

Beispiele

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

Ausnahmen

directory ist null.

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff auf directory.

directory steht für eine Datei, nicht für ein Verzeichnis.

CreateEntry(string, FileInfo, bool)

Erstellt einen einzelnen Eintrag im Archiv.

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

Parameter

name string

Der Name des Eintrags.

fileInfo FileInfo

Die Metadaten der Datei oder des Ordners, die komprimiert werden sollen.

openImmediately bool

Wahr, wenn die Datei sofort geöffnet werden soll, andernfalls wird die Datei beim Speichern des Archivs geöffnet.

Rückgabewert

CpioEntry

Cpio-Eintrag-Instanz.

Beispiele

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

Anmerkungen

Wenn die Datei sofort mit dem Parameter openImmediately geöffnet wird, wird sie blockiert, bis das Archiv verworfen wird.

Ausnahmen

name ist null.

name ist leer.

fileInfo ist null.

CreateEntry(string, string, bool)

Erstellt einen einzelnen Eintrag im Archiv.

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

Parameter

name string

Der Name des Eintrags.

sourcePath string

Pfad zur Datei, die komprimiert werden soll.

openImmediately bool

Wahr, wenn die Datei sofort geöffnet werden soll, andernfalls wird die Datei beim Speichern des Archivs geöffnet.

Rückgabewert

CpioEntry

Cpio-Eintrag-Instanz.

Beispiele

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

Anmerkungen

Der Eintragsname wird ausschließlich im Parameter name festgelegt. Der Dateiname, der im Parameter sourcePath angegeben ist, hat keinen Einfluss auf den Eintragsnamen.

Wenn die Datei sofort mit dem Parameter openImmediately geöffnet wird, wird sie blockiert, bis das Archiv verworfen wird.

Ausnahmen

sourcePath ist null.

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.

UnauthorizedAccessException

Der sourcePath ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen. - oder - Der Dateiname, der Teil von name ist, überschreitet 100 Zeichen.

Der Zugriff auf die Datei sourcePath ist verweigert.

Der angegebene sourcePath, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein. - oder - name ist zu lang für cpio.

Die Datei unter sourcePath enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.

CreateEntry(string, Stream)

Erstellt einen einzelnen Eintrag im Archiv.

public CpioEntry CreateEntry(string name, Stream source)

Parameter

name string

Der Name des Eintrags.

source Stream

Der Eingabestream für den Eintrag.

Rückgabewert

CpioEntry

Cpio-Eintrag-Instanz.

Beispiele

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

Ausnahmen

name ist null.

source ist null.

name ist leer.

DeleteEntry(CpioEntry)

Entfernt das erste Vorkommen eines bestimmten Eintrags aus der Eintragsliste.

public CpioArchive DeleteEntry(CpioEntry entry)

Parameter

entry CpioEntry

Der Eintrag, der aus der Eintragsliste entfernt werden soll.

Rückgabewert

Cpio-Eintrag-Instanz.

Beispiele

Hier ist, wie man alle Einträge außer dem letzten entfernt:

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

Ausnahmen

entry ist null.

DeleteEntry(int)

Entfernt den Eintrag aus der Eintragsliste nach Index.

public CpioArchive DeleteEntry(int entryIndex)

Parameter

entryIndex int

Der nullbasierte Index des zu entfernenden Eintrags.

Rückgabewert

ArgumentOutOfRangeException

Das Archiv mit dem gelöschten Eintrag.

Beispiele

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

Ausnahmen

entryIndex ist kleiner als 0.-oder- entryIndex ist gleich oder größer als Entries-Anzahl.

Dispose()

Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben von nicht verwalteten Ressourcen verbunden sind.

public void Dispose()

Dispose(bool)

Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben von nicht verwalteten Ressourcen verbunden sind.

protected virtual void Dispose(bool disposing)

Parameter

disposing bool

Ob verwaltete Ressourcen freigegeben werden sollen.

ExtractToDirectory(string)

Extrahiert alle Dateien im Archiv in das angegebene Verzeichnis.

public void ExtractToDirectory(string destinationDirectory)

Parameter

destinationDirectory string

Der Pfad zum Verzeichnis, in das die extrahierten Dateien abgelegt werden sollen.

Beispiele

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

Anmerkungen

Wenn das Verzeichnis nicht existiert, wird es erstellt.

Ausnahmen

path ist null

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff auf das vorhandene Verzeichnis.

Wenn das Verzeichnis nicht existiert, enthält der Pfad ein Doppelpunktzeichen (:) das nicht Teil eines Laufwerkslabels (“C:") ist.

path ist eine Nullzeichenfolge, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Ungültige Zeichen können durch die Verwendung der Methode System.IO.Path.GetInvalidPathChars abgefragt werden. - oder - path ist mit oder enthält nur ein Doppelpunktzeichen (:).

Das Verzeichnis, das durch den Pfad angegeben wird, ist eine Datei. - oder - Der Netzwerkname ist nicht bekannt.

Save(string, CpioFormat)

Speichert das Archiv in der angegebenen Zieldatei.

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

Parameter

destinationFileName string

Der Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei verweist, wird diese überschrieben.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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

Anmerkungen

Es ist möglich, ein Archiv im selben Pfad zu speichern, aus dem es geladen wurde. Dies wird jedoch nicht empfohlen, da dieser Ansatz das Kopieren in eine temporäre Datei verwendet.

Ausnahmen

destinationFileName ist eine Nullzeichenfolge, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen, wie sie von System.IO.Path.InvalidPathChars definiert sind.

destinationFileName ist null.

DirectoryNotFoundException

Der angegebene destinationFileName, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.

Der angegebene destinationFileName ist ungültig, (z. B. wenn er sich auf einem nicht zugeordneten Laufwerk befindet).

UnauthorizedAccessException

Ein E/A-Fehler ist aufgetreten, während die Datei geöffnet wurde.

destinationFileName gibt eine schreibgeschützte Datei an, auf die nicht zugegriffen werden kann. - oder - Der angegebene Pfad ist ein Verzeichnis. - oder - Der Aufrufer hat nicht die erforderliche Berechtigung.

destinationFileName hat ein ungültiges Format.

Save(Stream, CpioFormat)

Speichert das Archiv im angegebenen Stream.

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

Parameter

output Stream

Zielstream.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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

Anmerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.

output ist nicht beschreibbar. - oder - output ist derselbe Stream, aus dem wir extrahieren. - ODER - Es ist nicht möglich, das Archiv im cpioFormat aufgrund von Formatbeschränkungen zu speichern.

SaveGzipped(Stream, CpioFormat)

Speichert das Archiv im Stream mit gzip-Kompression.

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

Parameter

output Stream

Zielstream.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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

Anmerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.

output ist nicht beschreibbar.

SaveGzipped(string, CpioFormat)

Speichert das Archiv in der Datei nach Pfad mit gzip-Kompression.

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

Parameter

path string

Der Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei verweist, wird diese überschrieben.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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

SaveLZMACompressed(Stream, CpioFormat)

Speichert das Archiv im Stream mit LZMA-Kompression.

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

Parameter

output Stream

Zielstream.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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

Anmerkungen

output muss beschreibbar sein.

Wichtig: Das cpio-Archiv wird in dieser Methode erstellt und dann komprimiert, sein Inhalt wird intern aufbewahrt. Achten Sie auf den Speicherverbrauch.

SaveLZMACompressed(string, CpioFormat)

Speichert das Archiv in der Datei nach Pfad mit LZMA-Kompression.

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

Parameter

path string

Der Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei verweist, wird diese überschrieben.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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

Anmerkungen

Wichtig: Das cpio-Archiv wird in dieser Methode erstellt und dann komprimiert, sein Inhalt wird intern aufbewahrt. Achten Sie auf den Speicherverbrauch.

SaveLzipped(Stream, CpioFormat)

Speichert das Archiv im Stream mit Lzip-Kompression.

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

Parameter

output Stream

Zielstream.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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

Anmerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.

output ist nicht beschreibbar.

SaveLzipped(string, CpioFormat)

Speichert das Archiv in der Datei nach Pfad mit Lzip-Kompression.

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

Parameter

path string

Der Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei verweist, wird diese überschrieben.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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)

Speichert das Archiv im Stream mit xz-Kompression.

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

Parameter

output Stream

Zielstream.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

settings XzArchiveSettings

Einstellungen für das bestimmte xz-Archiv: Wörterbuchgröße, Blockgröße, Prüftyp.

Beispiele

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

Anmerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.

output ist nicht beschreibbar.

SaveXzCompressed(string, CpioFormat, XzArchiveSettings)

Speichert das Archiv im Pfad mit xz-Kompression.

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

Parameter

path string

Der Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei verweist, wird diese überschrieben.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

settings XzArchiveSettings

Einstellungen für das bestimmte xz-Archiv: Wörterbuchgröße, Blockgröße, Prüftyp.

Beispiele

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

SaveZCompressed(Stream, CpioFormat)

Speichert das Archiv im Stream mit Z-Kompression.

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

Parameter

output Stream

Zielstream.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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

Anmerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.

output ist nicht beschreibbar.

SaveZCompressed(string, CpioFormat)

Speichert das Archiv im Pfad mit Z-Kompression.

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

Parameter

path string

Der Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei verweist, wird diese überschrieben.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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

Speichert das Archiv im Stream mit Zstandard-Kompression.

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

Parameter

output Stream

Zielstream.

cpioFormat CpioFormat

Definiert das cpio-Headerformat.

Beispiele

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

Anmerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.