Class TarArchive

sourceStream ist nicht durchsuchbar.

TarArchive(string)

Initialisiert eine neue Instanz der Aspose.Zip.Tar.TarArchive-Klasse und erstellt eine Eintragsliste, die aus dem Archiv extrahiert werden kann.

public TarArchive(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 TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Bemerkungen

Dieser Konstruktor entpackt keinen Eintrag. Siehe die Aspose.Zip.Tar.TarEntry.Open-Methode 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.

Zugriff auf die Datei path ist verweigert.

Der angegebene path, Dateiname oder beides überschreiten die vom System definierten maximalen Längen. Beispielsweise müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.

DirectoryNotFoundException

Die Datei am 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<TarEntry>

Die Datei ist bereits geöffnet.

Eigenschaften

Entries

Erhält die Einträge des Typs Aspose.Zip.Tar.TarEntry, die das Archiv bilden.

public ReadOnlyCollection<tarentry> Entries { get; }

Eigenschaftswert

Methoden

CreateEntries(DirectoryInfo, bool)

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

public TarArchive 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

Das Archiv mit erstellten Einträgen.

Beispiele

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

CreateEntries(string, bool)

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

public TarArchive 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

Das Archiv mit erstellten Einträgen.

Beispiele

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

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 vom System definierten maximalen Längen. Beispielsweise 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.

CreateEntry(string, Stream, FileSystemInfo)

Erstellt einen einzelnen Eintrag im Archiv.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

Parameter

name string

Der Name des Eintrags.

source Stream

Der Eingabestream für den Eintrag.

fileInfo FileSystemInfo

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

Rückgabewert

TarEntry

Tar-Eintrag-Instanz.

Beispiele

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

Bemerkungen

Der Eintragsname wird ausschließlich im name-Parameter festgelegt. Der in fileInfo-Parameter angegebene Dateiname hat keinen Einfluss auf den Eintragsnamen.

fileInfo kann auf System.IO.DirectoryInfo verweisen, wenn der Eintrag ein Verzeichnis ist.

Ausnahmen

name ist zu lang für tar gemäß dem IEEE 1003.1-1998 Standard.

Der Dateiname als Teil von name überschreitet 100 Zeichen.

CreateEntry(string, FileInfo, bool)

Erstellt einen einzelnen Eintrag im Archiv.

public TarEntry 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

TarEntry

Tar-Eintrag-Instanz.

Beispiele

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

Bemerkungen

Der Eintragsname wird ausschließlich im name-Parameter festgelegt. Der in fileInfo-Parameter angegebene Dateiname hat keinen Einfluss auf den Eintragsnamen.

fileInfo kann auf System.IO.DirectoryInfo verweisen, wenn der Eintrag ein Verzeichnis ist.

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

Ausnahmen

name ist zu lang für tar gemäß dem IEEE 1003.1-1998 Standard.

Der Dateiname als Teil von name überschreitet 100 Zeichen.

CreateEntry(string, string, bool)

Erstellt einen einzelnen Eintrag im Archiv.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

Parameter

name string

Der Name des Eintrags.

path 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

TarEntry

Tar-Eintrag-Instanz.

Beispiele

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

Bemerkungen

Der Eintragsname wird ausschließlich im name-Parameter festgelegt. Der in path-Parameter angegebene Dateiname hat keinen Einfluss auf den Eintragsnamen.

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

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. - oder - Der Dateiname als Teil von name überschreitet 100 Zeichen.

Zugriff auf die Datei path ist verweigert.

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

DeleteEntry(TarEntry)

Entfernt das erste Vorkommen eines bestimmten Eintrags aus der Eintragsliste.

public TarArchive DeleteEntry(TarEntry entry)

Parameter

entry TarEntry

Der Eintrag, der aus der Eintragsliste entfernt werden soll.

Rückgabewert

Das Archiv mit dem gelöschten Eintrag.

Beispiele

So können Sie alle Einträge außer dem letzten entfernen:

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(int)

Entfernt den Eintrag anhand des Index aus der Eintragsliste.

public TarArchive 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 TarArchive("two_files.tar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.tar");
}

Ausnahmen

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

Dispose()

Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben nicht verwalteter Ressourcen verbunden sind.

public void Dispose()

Dispose(bool)

Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben nicht verwalteter 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 dem die extrahierten Dateien abgelegt werden sollen.

Beispiele

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

Bemerkungen

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 Laufwerksbezeichens (“C:") ist.

Der Pfad ist eine null-längige Zeichenfolge, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können nach ungültigen Zeichen suchen, indem Sie die Methode System.IO.Path.GetInvalidPathChars verwenden. - oder - Der Pfad ist mit einem Doppelpunktzeichen (:) vorangestellt oder enthält nur ein Doppelpunktzeichen.

Das durch den Pfad angegebene Verzeichnis ist eine Datei. - oder - Der Netzwerkname ist unbekannt.

FromGZip(Stream)

Extrahiert das bereitgestellte gzip-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das gzip-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromGZip(Stream source)

Parameter

source Stream

Die Quelle des Archivs.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Bemerkungen

Der GZip-Extraktionsstream ist aufgrund des Kompressionsalgorithmus nicht durchsuchbar. Das Tar-Archiv bietet die Möglichkeit, beliebige Aufzeichnungen zu extrahieren, sodass es im Hintergrund mit einem durchsuchbaren Stream arbeiten muss.

Ausnahmen

Das Archiv ist beschädigt.

FromGZip(string)

Extrahiert das bereitgestellte gzip-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das gzip-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromGZip(string path)

Parameter

path string

Der Pfad zur Archivdatei.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Bemerkungen

Ausnahmen

Das Archiv ist beschädigt.

FromLZMA(Stream)

Extrahiert das bereitgestellte LZMA-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das LZMA-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromLZMA(Stream source)

Parameter

source Stream

Die Quelle des Archivs.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Bemerkungen

Der LZMA-Extraktionsstream ist aufgrund des Kompressionsalgorithmus nicht durchsuchbar. Das Tar-Archiv bietet die Möglichkeit, beliebige Aufzeichnungen zu extrahieren, sodass es im Hintergrund mit einem durchsuchbaren Stream arbeiten muss.

FromLZMA(string)

Extrahiert das bereitgestellte LZMA-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das LZMA-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromLZMA(string path)

Parameter

path string

Der Pfad zur Archivdatei.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Bemerkungen

FromLZip(Stream)

Extrahiert das bereitgestellte lzip-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das lzip-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromLZip(Stream source)

Parameter

source Stream

Die Quelle des Archivs.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Bemerkungen

Der lzip-Extraktionsstream ist aufgrund des Kompressionsalgorithmus nicht durchsuchbar. Das Tar-Archiv bietet die Möglichkeit, beliebige Aufzeichnungen zu extrahieren, sodass es im Hintergrund mit einem durchsuchbaren Stream arbeiten muss.

FromLZip(string)

Extrahiert das bereitgestellte lzip-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: das lzip-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromLZip(string path)

Parameter

path string

Der Pfad zur Archivdatei.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Bemerkungen

FromXz(Stream)

Extrahiert das bereitgestellte xz-Format-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das xz-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromXz(Stream source)

Parameter

source Stream

Die Quelle des Archivs.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Bemerkungen

Das Tar-Archiv bietet die Möglichkeit, beliebige Aufzeichnungen zu extrahieren, sodass es im Hintergrund mit einem durchsuchbaren Stream arbeiten muss.

FromXz(string)

Extrahiert das bereitgestellte xz-Format-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das xz-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromXz(string path)

Parameter

path string

Der Pfad zur Archivdatei.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Bemerkungen

Das Tar-Archiv bietet die Möglichkeit, beliebige Aufzeichnungen zu extrahieren, sodass es im Hintergrund mit einem durchsuchbaren Stream arbeiten muss.

FromZ(Stream)

Extrahiert das bereitgestellte Z-Format-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das Z-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromZ(Stream source)

Parameter

source Stream

Die Quelle des Archivs.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Bemerkungen

Das Tar-Archiv bietet die Möglichkeit, beliebige Aufzeichnungen zu extrahieren, sodass es im Hintergrund mit einem durchsuchbaren Stream arbeiten muss.

FromZ(string)

Extrahiert das bereitgestellte Z-Format-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das Z-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromZ(string path)

Parameter

path string

Der Pfad zur Archivdatei.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Bemerkungen

Das Tar-Archiv bietet die Möglichkeit, beliebige Aufzeichnungen zu extrahieren, sodass es im Hintergrund mit einem durchsuchbaren Stream arbeiten muss.

FromZstandard(Stream)

Extrahiert das bereitgestellte Zstandard-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das Zstandard-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromZstandard(Stream source)

Parameter

source Stream

Die Quelle des Archivs.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Ausnahmen

Der Zstandard-Stream ist beschädigt oder nicht lesbar.

Die Daten sind beschädigt.

FromZstandard(string)

Extrahiert das bereitgestellte Zstandard-Archiv und erstellt ein Aspose.Zip.Tar.TarArchive aus den extrahierten Daten.

Wichtig: Das Zstandard-Archiv wird innerhalb dieser Methode vollständig extrahiert, sein Inhalt wird intern gespeichert. Achten Sie auf den Speicherverbrauch.

public static TarArchive FromZstandard(string path)

Parameter

path string

Der Pfad zur Archivdatei.

Rückgabewert

Eine Instanz von Aspose.Zip.Tar.TarArchive

Ausnahmen

Der Zstandard-Stream ist beschädigt oder nicht lesbar.

Die Daten sind beschädigt.

Save(Stream, TarFormat?)

Speichert das Archiv im angegebenen Stream.

public void Save(Stream output, TarFormat? format = null)

Parameter

output Stream

Zielstream.

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

Bemerkungen

output muss beschreibbar sein.

Ausnahmen

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

Save(string, TarFormat?)

Speichert das Archiv in der angegebenen Datei.

public void Save(string destinationFileName, TarFormat? format = null)

Parameter

destinationFileName string

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

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

Bemerkungen

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 null-längige Zeichenfolge, 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 vom System definierten maximalen Längen. Beispielsweise 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 I/O-Fehler ist aufgetreten, während die Datei geöffnet wurde.

destinationFileName gibt eine schreibgeschützte Datei an und der Zugriff ist nicht “Read”. - oder - Der angegebene Pfad ist ein Verzeichnis. - oder - Der Aufrufer hat nicht die erforderliche Berechtigung.

destinationFileName hat ein ungültiges Format.

FileNotFoundException

Die Datei wurde nicht gefunden.

SaveGzipped(Stream, TarFormat?)

Speichert das Archiv im Stream mit gzip-Kompression.

public void SaveGzipped(Stream output, TarFormat? format = null)

Parameter

output Stream

Zielstream.

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (FileStream result = File.OpenWrite("result.tar.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

Bemerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.

output ist nicht beschreibbar.

SaveGzipped(string, TarFormat?)

Speichert das Archiv in der Datei mit gzip-Kompression.

public void SaveGzipped(string path, TarFormat? format = null)

Parameter

path string

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

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.gz");
    }
}

SaveLZMACompressed(Stream, TarFormat?)

Speichert das Archiv im Stream mit LZMA-Kompression.

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

Parameter

output Stream

Zielstream.

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

Bemerkungen

output muss beschreibbar sein.

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

Ausnahmen

output ist null.

output ist nicht beschreibbar.

SaveLZMACompressed(string, TarFormat?)

Speichert das Archiv in der Datei mit LZMA-Kompression.

public void SaveLZMACompressed(string path, TarFormat? format = null)

Parameter

path string

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

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.tar.lzma");
    }
}

Bemerkungen

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

SaveLzipped(Stream, TarFormat?)

Speichert das Archiv im Stream mit lzip-Kompression.

public void SaveLzipped(Stream output, TarFormat? format = null)

Parameter

output Stream

Zielstream.

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (FileStream result = File.OpenWrite("result.tar.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLzipped(result);
        }
    }
}

Bemerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.

output ist nicht beschreibbar.

SaveLzipped(string, TarFormat?)

Speichert das Archiv in der Datei mit lzip-Kompression.

public void SaveLzipped(string path, TarFormat? format = null)

Parameter

path string

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

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.lz");
    }
}

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Speichert das Archiv im Stream mit xz-Kompression.

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

Parameter

output Stream

Zielstream.

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

settings XzArchiveSettings

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

Beispiele

using (FileStream result = File.OpenWrite("result.tar.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

Bemerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.

output ist nicht beschreibbar.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

Speichert das Archiv im Pfad mit xz-Kompression.

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

Parameter

path string

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

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

settings XzArchiveSettings

Set von 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 TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.tar.xz");
    }
}

SaveZCompressed(Stream, TarFormat?)

Speichert das Archiv im Stream mit Z-Kompression.

public void SaveZCompressed(Stream output, TarFormat? format = null)

Parameter

output Stream

Zielstream.

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (FileStream result = File.OpenWrite("result.tar.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

Bemerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.

output ist nicht beschreibbar.

SaveZCompressed(string, TarFormat?)

Speichert das Archiv im Pfad mit Z-Kompression.

public void SaveZCompressed(string path, TarFormat? format = null)

Parameter

path string

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

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.tar.Z");
    }
}

SaveZstandard(Stream, TarFormat?)

Speichert das Archiv im Stream mit Zstandard-Kompression.

public void SaveZstandard(Stream output, TarFormat? format = null)

Parameter

output Stream

Zielstream.

format TarFormat?

Definiert das Tar-Header-Format. Ein Nullwert wird, wenn möglich, als USTar behandelt.

Beispiele

using (FileStream result = File.OpenWrite("result.tar.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

Bemerkungen

output muss beschreibbar sein.

Ausnahmen

output ist null.