Class TarArchive

Class TarArchive

Der Name: Aspose.Zip.Tar Versammlung: Aspose.Zip.dll (25.5.0)

Diese Klasse repräsentiert eine Tar-Archivdatei. Verwenden Sie es, um tar-Dateien zu komponieren, zu extrahieren oder zu aktualisieren.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

Vererbte Mitglieder

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

Constructors

TarArchive()

Initialisiert eine neue Instanz der Aspose.Zip.Tar.TarArchive Klasse.

public TarArchive()

Examples

Das folgende Beispiel zeigt, wie man eine Datei komprimiert.

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

TarArchive(Stream)

Initialisiert eine neue Instanz der Aspose.Zip.Archive-Klasse und komponiert eine Eingabeliste, die aus dem Archiv extrahiert werden kann.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

Die Quelle des Archivs. es muss nachfindlich sein.

Examples

Das folgende Beispiel zeigt, wie man alle Beiträge in ein Katalog extrahiert.

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

Remarks

Dieser Konstruktor entpackt keine Einträge. siehe Aspose.Zip.Tar.TarEntry.Open Methode für Entpacken.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(String)

Initialisiert eine neue Instanz der Aspose.Zip.Tar.tarArchive-Klasse und stellt eine Einträgeliste aus dem Archiv heraus.

public TarArchive(string path)

Parameters

path string

Der Weg zum Archiv.

Examples

Das folgende Beispiel zeigt, wie man alle Beiträge in ein Katalog extrahiert.

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

Remarks

Dieser Konstruktor entpackt keine Einträge. siehe Aspose.Zip.Tar.TarEntry.Open Methode für Entpacken.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.

ArgumentException

Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.

UnauthorizedAccessException

Der Zugriff auf die Datei path" wird abgelehnt.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

NotSupportedException

Die Datei bei path’ enthält eine Kolonne (:) in der Mitte der Zeile.

FileNotFoundException

Die Datei ist nicht gefunden.

DirectoryNotFoundException

Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.

IOException

Die Datei ist bereits geöffnet.

Properties

Entries

Er bekommt Beiträge von Aspose.Zip.Tar.TarEntry Typ, die das Archiv darstellt.

public ReadOnlyCollection<tarentry> Entries { get; }

Eigentumswert

ReadOnlyCollection &undlt; TarEntry >

Methods

CreateEntries(VerzeichnisInfo, Bool)

Add to the archive all the files and directories recurrently in the given directory. - Add to the archive all the files and directories recurrently in the given directory.

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

Parameters

directory DirectoryInfo

Verzeichnis zum Komprimieren.

includeRootDirectory bool

Angibt, ob die Root-Dokumentation selbst enthalten ist oder nicht.

Returns

TarArchive

Das Archiv mit enthaltenen Beiträgen.

Examples

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 und Bool)

Add to the archive all the files and directories recurrently in the given directory. - Add to the archive all the files and directories recurrently in the given directory.

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

Parameters

sourceDirectory string

Verzeichnis zum Komprimieren.

includeRootDirectory bool

Angibt, ob die Root-Dokumentation selbst enthalten ist oder nicht.

Returns

TarArchive

Das Archiv mit enthaltenen Beiträgen.

Examples

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

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

Der Anrufgeber hat nicht die erforderliche Erlaubnis zum Zugriff auf sourceDirectory'.

ArgumentException

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

PathTooLongException

Die angegebenen Path, Dateinamen oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel müssen auf Windows-basierten Plattformen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

CreateEntry(String, Stream und FileSystemInfo)

Erstellen Sie einen einzigen Eingang innerhalb des Archivs.

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

Parameters

name string

Der Name des Eingangs.

source Stream

Der Eingangstrom für den Eingang.

fileInfo FileSystemInfo

Die Metadaten von Datei oder Ordner zu komprimieren.

Returns

TarEntry

Eintritt in die Instanz.

Examples

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

Remarks

Der im Parameter angegebenen Dateiname beeinflusst nicht den Eingangsnamen.

Sie können auf System.IO.DirectoryInfo beziehen, wenn die Eingabe ein Katalog ist.

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

Der Dateiname, als Teil des name’, übersteigt 100 Symbole.

CreateEntry(String, FileInfo und Bool)

Erstellen Sie einen einzigen Eingang innerhalb des Archivs.

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

Parameters

name string

Der Name des Eingangs.

fileInfo FileInfo

Die Metadaten von Datei oder Ordner zu komprimieren.

openImmediately bool

Wahrlich, wenn Sie die Datei sofort öffnen, öffnen Sie sonst die Datei auf Archiv-Speicher.

Returns

TarEntry

Eintritt in die Instanz.

Examples

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

Remarks

Der im Parameter angegebenen Dateiname beeinflusst nicht den Eingangsnamen.

Sie können auf System.IO.DirectoryInfo beziehen, wenn die Eingabe ein Katalog ist.

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

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

Der Dateiname, als Teil des name’, übersteigt 100 Symbole.

CreateEntry(String, String und Bool)

Erstellen Sie einen einzigen Eingang innerhalb des Archivs.

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

Parameters

name string

Der Name des Eingangs.

path string

Der Weg zum Datei zu komprimieren.

openImmediately bool

Wahrlich, wenn Sie die Datei sofort öffnen, öffnen Sie sonst die Datei auf Archiv-Speicher.

Returns

TarEntry

Eintritt in die Instanz.

Examples

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

Remarks

Der im Parameter angegebenen Dateiname beeinflusst nicht den Eingangsnamen.

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.

ArgumentException

Die path’ ist leer, enthält nur weiße Räume, oder enthält ungültige Zeichen. - oder - Dateinamen, als Teil der name’, übersteigt 100 Symbole.

UnauthorizedAccessException

Der Zugriff auf die Datei path” wird abgelehnt.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen auf Windows-basierten Plattformen die Paths weniger als 248 Zeichen sein und die Dateinamen weniger als 260 Zeichen sein. - oder - name’ ist zu lang für tar als der IEEE 1003.1-1998 Standard.

NotSupportedException

Die Datei bei path’ enthält eine Kolonne (:) in der Mitte der Zeile.

DeleteEntry(TarEntry)

Entfernen Sie das erste Auftreten eines bestimmten Eintrags aus der Eintragsliste.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

Eintritt zu entfernen aus der Eintrittsliste.

Returns

TarArchive

Das Archiv mit dem Eingang gelöscht.

Examples

Hier ist, wie Sie alle Beiträge mit Ausnahme des letzten entfernen können:

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

DeleteEntry(Int)

Entfernen Sie den Eingang aus der Eingangsliste durch Index.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

Der null-basierte Index des Eingangs zu entfernen.

Returns

TarArchive

Das Archiv mit dem Eingang gelöscht.

Examples

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

Exceptions

ArgumentOutOfRangeException

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

Dispose()

Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.

public void Dispose()

Dispose(Bool)

Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Ob verwaltete Ressourcen abgeschieden werden sollten.

ExtractToDirectory(String)

Entfernen Sie alle Dateien im Archiv in das angebotene Katalog.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Der Weg zum Katalog, um die extrahierten Dateien in.

Examples

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

Remarks

Wenn das Katalog nicht existiert, wird es erstellt.

Exceptions

ArgumentNullException

Der Weg ist null

PathTooLongException

Die angegebenen Path, Dateinamen oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel müssen auf Windows-basierten Plattformen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

SecurityException

Der Anrufgeber hat nicht die erforderliche Erlaubnis, das bestehende Direktorium zuzugreifen.

NotSupportedException

Wenn der Direktor nicht existiert, enthält der Pfad einen Zollkarakter (:) der nicht Teil eines Labels ist (“C:”).

ArgumentException

Path ist eine nulllänge String, enthält nur weiße Räume, oder enthalten einen oder mehrere invalid Charaktere. Sie können für invalide Characters durch die System.IO.Path.GetInvalidPatChars Methode fragen. - oder - Pate ist mit, bzw. enthielt, nur ein Kolon Charakter (:).

IOException

Die durch den Weg angegebenen Katalog ist eine Datei. - oder - Der Netzwerkname ist nicht bekannt.

von GZIP(Stream)

Extracts geliefert gzip Archiv und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: Gzip-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

Die Quelle des Archivs.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

GZip-Extraktionsstrom ist nicht durch die Natur des Komprimierungsalgoritms erforscht.Das Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnungen zu extrahieren, so dass es unter dem Hut einen suchtbaren Strom ausführen muss.

Exceptions

InvalidDataException

Das Archiv ist korrupt.

von GZIP(String)

Extracts geliefert gzip Archiv und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: Gzip-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromGZip(string path)

Parameters

path string

Der Weg zum Archiv.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

GZip-Extraktionsstrom ist nicht durch die Natur des Komprimierungsalgoritms erforscht.Das Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnungen zu extrahieren, so dass es unter dem Hut einen suchtbaren Strom ausführen muss.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.

UnauthorizedAccessException

Der Zugriff auf die Datei path" wird abgelehnt.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

NotSupportedException

Die Datei bei path" ist in einem invalidformat.

DirectoryNotFoundException

Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.

FileNotFoundException

Die Datei ist nicht gefunden.

InvalidDataException

Das Archiv ist korrupt.

von LZ4(String)

Extracts lieferte LZ4 Archiv und komponiert Aspose.Zip.Tar.tarArchive aus extrahierten Daten.

Wichtig: LZ4 Archiv wird vollständig innerhalb dieser Methode extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromLZ4(string path)

Parameters

path string

Der Weg zum Archiv.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

LZ4 Extraction Stream ist nicht durch die Natur des Komprimierungsalgoritms gesucht. Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnung zu extrahieren, so dass es den gesuchten Strom unter dem Hut ausführen muss.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Der Anrufgeber hat nicht die erforderliche Genehmigung zum Zugriff

ArgumentException

Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.

UnauthorizedAccessException

Der Zugriff auf die Datei path" wird abgelehnt.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

NotSupportedException

Die Datei bei path" ist in einem invalidformat.

DirectoryNotFoundException

Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.

FileNotFoundException

Die Datei ist nicht gefunden.

EndOfStreamException

Die Datei ist zu kurz.

InvalidDataException

Die Datei hat die falsche Unterschrift.

von LZ4(Stream)

Extracts lieferte LZ4 Archiv und komponiert Aspose.Zip.Tar.tarArchive aus extrahierten Daten.

Wichtig: LZ4 Archiv wird vollständig innerhalb dieser Methode extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

Die Quelle des Archivs.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

LZ4 Extraction Stream ist nicht durch die Natur des Komprimierungsalgoritms gesucht. Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnung zu extrahieren, so dass es den gesuchten Strom unter dem Hut ausführen muss.

Exceptions

ArgumentException

kann nicht von source’ gelesen werden

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

Die source’ hat die falsche Signatur.

von LZMA(Stream)

Extracts lieferte LZMA Archiv und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: LZMA-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

Die Quelle des Archivs.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

LZMA-Extraktionsstrom ist nicht durch die Natur des Komprimierungsalgorithms suchtbar. Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnung zu extrahieren, so dass es den suchtbaren Strom unter dem Hut ausführen muss.

Exceptions

InvalidDataException

Das Archiv ist korrupt.

von LZMA(String)

Extracts lieferte LZMA Archiv und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: LZMA-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromLZMA(string path)

Parameters

path string

Der Weg zum Archiv.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

LZMA-Extraktionsstrom ist nicht durch die Natur des Komprimierungsalgorithms suchtbar. Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnung zu extrahieren, so dass es unter dem Hut nachsuchtes Strom ausführen muss.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.

UnauthorizedAccessException

Der Zugriff auf die Datei path" wird abgelehnt.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

NotSupportedException

Die Datei bei path" ist in einem invalidformat.

DirectoryNotFoundException

Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.

FileNotFoundException

Die Datei ist nicht gefunden.

von LZIP(Stream)

Extracts geliefert Lzip-Archive und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: Lzip-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

Die Quelle des Archivs.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

Lzip-Extraktionsstrom ist nicht durch die Natur des Komprimierungsalgorithms suchtbar. Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnung zu extrahieren, so dass es den suchtbaren Strom unter dem Hut ausführen muss.

Exceptions

InvalidDataException

Das Archiv ist korrupt.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

von LZIP(String)

Extracts geliefert Lzip-Archive und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: Lzip-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromLZip(string path)

Parameters

path string

Der Weg zum Archiv.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

Lzip-Extraktionsstrom ist nicht durch die Natur des Komprimierungsalgorithms suchtbar. Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnung zu extrahieren, so dass es den suchtbaren Strom unter dem Hut ausführen muss.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.

UnauthorizedAccessException

Der Zugriff auf die Datei path" wird abgelehnt.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

NotSupportedException

Die Datei bei path" ist in einem invalidformat.

DirectoryNotFoundException

Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.

FileNotFoundException

Die Datei ist nicht gefunden.

InvalidDataException

Das Archiv ist korrupt.

FromXz(Stream)

Extrakte versorgt xz-Format-Archiv und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: xz-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

Die Quelle des Archivs.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

Das Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnungen zu extrahieren, so dass es unter dem Hut einen suchtbaren Strom ausführen muss.

FromXz(String)

Extrakte versorgt xz-Format-Archiv und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: xz-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromXz(string path)

Parameters

path string

Der Weg zum Archiv.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

Das Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnungen zu extrahieren, so dass es unter dem Hut einen suchtbaren Strom ausführen muss.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.

UnauthorizedAccessException

Der Zugriff auf die Datei path" wird abgelehnt.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

NotSupportedException

Die Datei bei path" ist in einem invalidformat.

DirectoryNotFoundException

Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.

FileNotFoundException

Die Datei ist nicht gefunden.

von Z(Stream)

Extracts liefert Z-Format-Archiv und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: Z-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

Die Quelle des Archivs.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

Das Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnungen zu extrahieren, so dass es unter dem Hut einen suchtbaren Strom ausführen muss.

von Z(String)

Extracts liefert Z-Format-Archiv und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: Z-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromZ(string path)

Parameters

path string

Der Weg zum Archiv.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Remarks

Das Tar-Archiv bietet die Möglichkeit, arbiträre Aufzeichnungen zu extrahieren, so dass es unter dem Hut einen suchtbaren Strom ausführen muss.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.

UnauthorizedAccessException

Der Zugriff auf die Datei path" wird abgelehnt.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

NotSupportedException

Die Datei bei path" ist in einem invalidformat.

DirectoryNotFoundException

Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.

FileNotFoundException

Die Datei ist nicht gefunden.

FromZstandard(Stream)

Extracts geliefert Zstandard Archiv und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: Das Standard-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

Die Quelle des Archivs.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Zstandard Stream ist korrupt oder nicht lesbar.

InvalidDataException

Die Daten sind korrupt.

FromZstandard(String)

Extracts geliefert Zstandard Archiv und komponiert Aspose.Zip.Tar.TarArchive aus extrahierten Daten.

Wichtig: Das Standard-Archiv wird in dieser Methode vollständig extrahiert, seine Inhalte werden intern beibehalten.

public static TarArchive FromZstandard(string path)

Parameters

path string

Der Weg zum Archiv.

Returns

TarArchive

Ein Beispiel von Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.

UnauthorizedAccessException

Der Zugriff auf die Datei path" wird abgelehnt.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

NotSupportedException

Die Datei bei path" ist in einem invalidformat.

DirectoryNotFoundException

Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.

FileNotFoundException

Die Datei ist nicht gefunden.

IOException

Zstandard Stream ist korrupt oder nicht lesbar.

InvalidDataException

Die Daten sind korrupt.

Save(Stream oder TarFormat?)

Speichern Sie Archive für den bereitgestellten Strom.

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

Parameters

output Stream

Der Destinationstrom.

format TarFormat ?

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

Examples

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

Remarks

Es muss geschrieben werden.

Exceptions

ArgumentException

output’ is not writable. - or - output’ is the same stream we extract from.- OR -It is impossible to save archive in format’ due to format restrictions.

Save(String und TarFormat?)

Speichern Sie das Archiv zu einem bereitgestellten Zieldatei.

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

Parameters

destinationFileName string

Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.

format TarFormat ?

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

Examples

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

Remarks

Es ist möglich, ein Archiv auf dem gleichen Weg zu speichern, wie es heruntergeladen wurde. jedoch wird dies nicht empfohlen, weil dieser Ansatz Kopieren zu einer vorübergehenden Datei verwendet.

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

Die angegebenen destinationFileName’, Dateiname, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Spuren weniger als 248 Zeichen und die Dateinamen weniger als 260 Zeichen sein.

DirectoryNotFoundException

Die angegebenen destinationFileName’ ist ungültig (z. B. auf einem unmapped-Drive).

IOException

Ein I/O-Fehler kam beim Öffnen der Datei auf.

UnauthorizedAccessException

destinationFileName’ specified a file that 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.

FileNotFoundException

Die Datei ist nicht gefunden.

SaveGzipped(Stream oder TarFormat?)

Speichern Sie Archive in den Stream mit gzip-Kompression.

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

Parameters

output Stream

Der Destinationstrom.

format TarFormat ?

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

Examples

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

Remarks

Es muss geschrieben werden.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(String und TarFormat?)

Speichert die Datei mit gzip-Kompression.

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

Parameters

path string

Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.

format TarFormat ?

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

Examples

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

Exceptions

UnauthorizedAccessException

Der Anrufer hat nicht die erforderliche Erlaubnis. -or- path’ angegeben ein lesen nur Datei oder Katalog.

ArgumentException

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

ArgumentNullException

path’ is null.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

DirectoryNotFoundException

Die angegebenen path’ ist ungültig (z. B. auf einem unmapped-Drive).

NotSupportedException

path’ is in an invalid format.

SaveLZ4 Komprimiert(Stream oder TarFormat?)

Er spart den Archiv in den Strom mit LZ4 Kompression.

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

Parameters

output Stream

Der Destinationstrom.

format TarFormat ?

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

Examples

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

Remarks

Es muss geschrieben werden.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZ4 Komprimiert(String und TarFormat?)

Speichert die Datei mit LZ4 Kompression.

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

Parameters

path string

Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.

format TarFormat ?

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

Examples

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

Exceptions

UnauthorizedAccessException

Der Anrufer hat nicht die erforderliche Erlaubnis. -or- path’ angegeben ein lesen nur Datei oder Katalog.

ArgumentException

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

ArgumentNullException

path’ is null.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

DirectoryNotFoundException

Die angegebenen path’ ist ungültig (z. B. auf einem unmapped-Drive).

NotSupportedException

path’ is in an invalid format.

Gefüllung komprimiert(Stream oder TarFormat?)

Er spart den Archiv in den Strom mit LZMA-Kompression.

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

Parameters

output Stream

Der Destinationstrom.

format TarFormat ?

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

Examples

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

Remarks

Es muss geschrieben werden.

Wichtig: Tar-Archiv wird dann in dieser Methode komprimiert, sein Inhalt wird intern beibehalten.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Gefüllung komprimiert(String und TarFormat?)

Speichert die Datei auf dem Weg mit lzma-Kompression.

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

Parameters

path string

Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.

format TarFormat ?

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

Examples

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

Remarks

Wichtig: Tar-Archiv wird dann in dieser Methode komprimiert, sein Inhalt wird intern beibehalten.

Exceptions

UnauthorizedAccessException

Der Anrufer hat nicht die erforderliche Erlaubnis. -or- path’ angegeben ein lesen nur Datei oder Katalog.

ArgumentException

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

ArgumentNullException

path’ is null.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

DirectoryNotFoundException

Die angegebenen path’ ist ungültig (z. B. auf einem unmapped-Drive).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Stream oder TarFormat?)

Speichern Sie Archive in den Strom mit Lzip-Kompression.

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

Parameters

output Stream

Der Destinationstrom.

format TarFormat ?

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

Examples

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

Remarks

Es muss geschrieben werden.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(String und TarFormat?)

Speichert die Datei mit Lzip-Kompression.

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

Parameters

path string

Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.

format TarFormat ?

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

Examples

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

Exceptions

UnauthorizedAccessException

Der Anrufer hat nicht die erforderliche Erlaubnis. -or- path’ angegeben ein lesen nur Datei oder Katalog.

ArgumentException

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

ArgumentNullException

path’ is null.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

DirectoryNotFoundException

Die angegebenen path’ ist ungültig (z. B. auf einem unmapped-Drive).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Er spart den Archiv in den Strom mit xz-Kompression.

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

Parameters

output Stream

Der Destinationstrom.

format TarFormat ?

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

settings XzArchiveSettings

Set der Einrichtung bestimmter xz-Archive: Wörterbuchgröße, Blockgröße, Check-Typ.

Examples

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

Remarks

Der Stream muss schriftlich sein.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(String, TarFormat?, XzArchiveSettings)

Speichert Archiv auf den Weg mit xz-Kompressionen.

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

Parameters

path string

Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.

format TarFormat ?

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

settings XzArchiveSettings

Set der Einrichtung bestimmter xz-Archive: Wörterbuchgröße, Blockgröße, Check-Typ.

Examples

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

Exceptions

UnauthorizedAccessException

Der Anrufer hat nicht die erforderliche Erlaubnis. -or- path’ angegeben ein lesen nur Datei oder Katalog.

ArgumentException

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

ArgumentNullException

path’ is null.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

DirectoryNotFoundException

Die angegebenen path’ ist ungültig (z. B. auf einem unmapped-Drive).

NotSupportedException

path’ is in an invalid format.

Gefüllung komprimiert(Stream oder TarFormat?)

Er spart den Archiv in den Strom mit Z-Kompression.

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

Parameters

output Stream

Der Destinationstrom.

format TarFormat ?

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

Examples

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

Remarks

Es muss geschrieben werden.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Gefüllung komprimiert(String und TarFormat?)

Er spart Archiv auf den Weg mit Z-Kompressionen.

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

Parameters

path string

Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.

format TarFormat ?

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

Examples

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

Exceptions

UnauthorizedAccessException

Der Anrufer hat nicht die erforderliche Erlaubnis. -or- path’ angegeben ein lesen nur Datei oder Katalog.

ArgumentException

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

ArgumentNullException

path’ is null.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

DirectoryNotFoundException

Die angegebenen path’ ist ungültig (z. B. auf einem unmapped-Drive).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Stream oder TarFormat?)

Speichern Sie Archive in den Strom mit Standard-Kompression.

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

Parameters

output Stream

Der Destinationstrom.

format TarFormat ?

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

Examples

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

Remarks

Es muss geschrieben werden.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(String und TarFormat?)

Speichert die Datei auf dem Weg mit Zstandard-Kompression.

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

Parameters

path string

Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.

format TarFormat ?

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

Examples

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

Exceptions

UnauthorizedAccessException

Der Anrufer hat nicht die erforderliche Erlaubnis. -or- path’ angegeben ein lesen nur Datei oder Katalog.

ArgumentException

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

ArgumentNullException

path’ is null.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

DirectoryNotFoundException

Die angegebenen path’ ist ungültig (z. B. auf einem unmapped-Drive).

NotSupportedException

path’ is in an invalid format.

 Deutsch