Class TarArchive

Class TarArchive

Nazwa przestrzeń: Aspose.Zip.Tar Zestawienie: Aspose.Zip.dll (25.5.0)

Ta klasa reprezentuje plik archiwum tar. Użyj go do kompozycji, ekstrakcji lub aktualizacji archivów Tar.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

Dziedziczeni członkowie

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

Constructors

TarArchive()

Inicjalizuje nową instancję klasy Aspose.Zip.Tar.TarArchive.

public TarArchive()

Examples

Poniższy przykład pokazuje, jak kompresować plik.

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

TarArchive(Stream)

Inicjalizuje nową instancję klasy Aspose.Zip.Archive i tworzy listę wpisów, które można wyciągnąć z archiwum.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

Źródło archiwum - musi być wyszukiwane.

Examples

Poniższy przykład pokazuje, jak wyciągnąć wszystkie wpisy do katalogu.

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

Remarks

Konstruktor ten nie odpakuje żadnych wpisów. zobacz Aspose.Zip.Tar.TarEntry.Otwarte metody odpakowania.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(strumień)

Inicjalizuje nową instancję klasy Aspose.Zip.Tar.tarArchive i tworzy listę wpisów, które można wyciągnąć z archiwum.

public TarArchive(string path)

Parameters

path string

Droga do archiwum.

Examples

Poniższy przykład pokazuje, jak wyciągnąć wszystkie wpisy do katalogu.

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

Remarks

Konstruktor ten nie odpakuje żadnych wpisów. zobacz Aspose.Zip.Tar.TarEntry.Otwarte metody odpakowania.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp.

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path’ zawiera kolumnę (:) w środku paska.

FileNotFoundException

Plik nie został znaleziony.

DirectoryNotFoundException

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

IOException

Archiwum jest już otwarte.

Properties

Entries

Otrzymuje wpisy typu Aspose.Zip.Tar.TarEntry tworzącego archiwum.

public ReadOnlyCollection<tarentry> Entries { get; }

Wartość nieruchomości

ReadOnlyCollection • < TarEntry >

Methods

CreateEntries(Informacje, Bool)

Dodaj do archiwum wszystkie pliki i katalogi ponownie w danym katalogu.

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

Parameters

directory DirectoryInfo

Dyrekcja do kompresji.

includeRootDirectory bool

Oznacza, czy należy włączyć sam katalog korzeniowy, czy nie.

Returns

TarArchive

Archiwum z składanymi wpisami.

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(Złoty, Bool)

Dodaj do archiwum wszystkie pliki i katalogi ponownie w danym katalogu.

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

Parameters

sourceDirectory string

Dyrekcja do kompresji.

includeRootDirectory bool

Oznacza, czy należy włączyć sam katalog korzeniowy, czy nie.

Returns

TarArchive

Archiwum z składanymi wpisami.

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

Wzywacz nie ma wymaganej zgody na dostęp do sourceDirectory'.

ArgumentException

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

PathTooLongException

Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

CreateEntry(strumień, strumień, FileSystemInfo)

Tworzenie jednego wpisu w archiwum.

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

Parameters

name string

Nazwa wejścia.

source Stream

Przepływ wejściowy dla wejścia.

fileInfo FileSystemInfo

Metadane plików lub folderów do kompresji.

Returns

TarEntry

Wejście do instancji.

Examples

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

Remarks

Nazwa wpisu jest ustawiona wyłącznie w parametrze. nazwa pliku podana w parametrze nie wpływa na nazwę wpisu.

można odwołać się do System.IO.DirectoryInfo, jeśli wpis jest adresem.

Exceptions

PathTooLongException

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

ArgumentException

Nazwa pliku, jako część nazwy ”, przekracza 100 symboli.

CreateEntry(Źródło: FileInfo, Bool)

Tworzenie jednego wpisu w archiwum.

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

Parameters

name string

Nazwa wejścia.

fileInfo FileInfo

Metadane plików lub folderów do kompresji.

openImmediately bool

Prawda jest taka, że jeśli natychmiast otworzysz plik, w przeciwnym razie otwórz plik na archiwum.

Returns

TarEntry

Wejście do instancji.

Examples

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

Remarks

Nazwa wpisu jest ustawiona wyłącznie w parametrze. nazwa pliku podana w parametrze nie wpływa na nazwę wpisu.

można odwołać się do System.IO.DirectoryInfo, jeśli wpis jest adresem.

Jeśli plik zostanie natychmiast otwarty parametrem, zostanie on zablokowany, dopóki nie zostanie usunięty archiwum.

Exceptions

PathTooLongException

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

ArgumentException

Nazwa pliku, jako część nazwy ", przekracza 100 symboli.

CreateEntry(String, String i Bool)

Tworzenie jednego wpisu w archiwum.

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

Parameters

name string

Nazwa wejścia.

path string

Ścieżka do rejestracji do kompresji.

openImmediately bool

Prawda jest taka, że jeśli natychmiast otworzysz plik, w przeciwnym razie otwórz plik na archiwum.

Returns

TarEntry

Wejście do instancji.

Examples

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

Remarks

Nazwa wpisu jest ustawiona wyłącznie w parametrze. nazwa pliku podana w parametrze nie wpływa na nazwę wpisu.

Jeśli plik zostanie natychmiast otwarty parametrem, zostanie on zablokowany, dopóki nie zostanie usunięty archiwum.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp.

ArgumentException

path’ jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky. - lub - Nazwa pliku, jako część name’, przekracza 100 symboli.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków. - lub - name’ jest zbyt długi dla tar w porównaniu z standardem IEEE 1003.1-1998.

NotSupportedException

Plik w path’ zawiera kolumnę (:) w środku paska.

DeleteEntry(TarEntry)

Usuwa pierwsze pojawienie się określonego wpisu z listy wpisów.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

Wstęp do usunięcia z listy wpisów.

Returns

TarArchive

Archiwum z wpisem usunięte.

Examples

Oto jak można usunąć wszystkie wpisy z wyjątkiem ostatniego:

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

DeleteEntry(Int)

Usunąć wpis z listy wpisów według indeksu.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

Wskaźnik oparty na zero wejścia do usunięcia.

Returns

TarArchive

Archiwum z wpisem usunięte.

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

Wykonywanie zadań określonych w aplikacji związanych z uwalnianiem, uwalnianiem lub ponownym uwalnianiem nie zarządzanych zasobów.

public void Dispose()

Dispose(Bool)

Wykonywanie zadań określonych w aplikacji związanych z uwalnianiem, uwalnianiem lub ponownym uwalnianiem nie zarządzanych zasobów.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Czy zarządzane zasoby powinny zostać usunięte?

ExtractToDirectory(strumień)

Wyciąga wszystkie pliki w archiwum do dostarczonego katalogu.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Droga do katalogu, aby umieścić wyciągnięte pliki.

Examples

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

Remarks

Jeśli dyrektywa nie istnieje, zostanie ona utworzona.

Exceptions

ArgumentNullException

Droga jest zero

PathTooLongException

Na przykład, na platformach z systemem Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

SecurityException

Odwołujący nie posiada wymaganej pozwolenia na dostęp do istniejącego katalogu.

NotSupportedException

Jeśli dyrektywa nie istnieje, ścieżka zawiera znak kolumny (:) który nie jest częścią etykiety napędu (“C:”).

ArgumentException

Ścieżka jest łańcuchem zerowej długości, zawiera tylko biały przestrzeń lub zawiera jeden lub więcej nieprawidłowych znaków. Możesz zapytać o nieważne znaky za pomocą metody System.IO.Path.GetInvalid PathChars. - lub - droga jest uprzednio ustawiona z, albo zawiera, tylko znak kolonu (:).

IOException

Dyskusja określona przez ścieżkę jest plikiem. - lub - Nazwa sieci nie jest znana.

od GZIP(Stream)

Ekstrakty dostarczone gzip archiwum i tworzy Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: archiwum gzip jest w pełni wyodrębnione w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

Źródło tego archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Strumień ekstrakcji GZip nie jest poszukiwany przez naturę algorytmu kompresji.Archiwum Tar umożliwia wydobycie arbitralnych rekordów, więc musi działać strumień poszukiwany pod szufladą.

Exceptions

InvalidDataException

Archiwum jest zepsute.

od GZIP(strumień)

Ekstrakty dostarczone gzip archiwum i tworzy Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: archiwum gzip jest w pełni wyodrębnione w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromGZip(string path)

Parameters

path string

Droga do archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Strumień ekstrakcji GZip nie jest poszukiwany przez naturę algorytmu kompresji.Archiwum Tar umożliwia wydobycie arbitralnych rekordów, więc musi działać strumień poszukiwany pod szufladą.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path" znajduje się w nieprawidłowym formacie.

DirectoryNotFoundException

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

FileNotFoundException

Plik nie został znaleziony.

InvalidDataException

Archiwum jest zepsute.

od LZ4(strumień)

Ekstrakty dostarczone do archiwum LZ4 i tworzą Aspose.Zip.Tar.tarArchive z wyciągniętych danych.

Ważne: Archiwum LZ4 jest w pełni wyciągnięte w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromLZ4(string path)

Parameters

path string

Droga do archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Strumień ekstrakcji LZ4 nie jest wyszukiwany przez naturę algorytmu kompresji. archiwum Tar zapewnia możliwość wyciągania arbitralnych rekordów, więc musi działać strumienie wyszukane pod szufladą.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path" znajduje się w nieprawidłowym formacie.

DirectoryNotFoundException

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

FileNotFoundException

Plik nie został znaleziony.

EndOfStreamException

Plik jest zbyt krótki.

InvalidDataException

Artykuł ma niewłaściwy podpis.

od LZ4(Stream)

Ekstrakty dostarczone do archiwum LZ4 i tworzą Aspose.Zip.Tar.tarArchive z wyciągniętych danych.

Ważne: Archiwum LZ4 jest w pełni wyciągnięte w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

Źródło tego archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Strumień ekstrakcji LZ4 nie jest wyszukiwany przez naturę algorytmu kompresji. archiwum Tar zapewnia możliwość wyciągania arbitralnych rekordów, więc musi działać strumienie wyszukane pod szufladą.

Exceptions

ArgumentException

Nie można przeczytać z source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

Źródło " ma niewłaściwy podpis.

od LZMA(Stream)

Ekstrakty dostarczone do archiwum LZMA i tworzą Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: Archiwum LZMA jest w pełni wyciągnięte w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

Źródło tego archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Strumień ekstrakcji LZMA nie jest poszukiwany przez naturę algorytmu kompresji. archiwum Tar zapewnia możliwość ekstrakcji arbitralnych rekordów, więc musi działać poszukiwany strumień pod szufladą.

Exceptions

InvalidDataException

Archiwum jest zepsute.

od LZMA(strumień)

Ekstrakty dostarczone do archiwum LZMA i tworzą Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: Archiwum LZMA jest w pełni wyciągnięte w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromLZMA(string path)

Parameters

path string

Droga do archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Strumień ekstrakcji LZMA nie jest poszukiwany przez naturę algorytmu kompresji. archiwum Tar zapewnia możliwość wyciągania arbitralnych rekordów, więc musi działać wyszukiwane strumienie pod szufladą.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path" znajduje się w nieprawidłowym formacie.

DirectoryNotFoundException

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

FileNotFoundException

Plik nie został znaleziony.

od LZIP(Stream)

Ekstrakty dostarczone archiwum lzip i tworzy Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: archiwum lzip jest w pełni wyodrębnione w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

Źródło tego archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Strumień ekstrakcji Lzip nie jest poszukiwany przez naturę algorytmu kompresji. archiwum Tar zapewnia możliwość ekstrakcji arbitralnych rekordów, więc musi działać poszukiwany strumień pod szufladą.

Exceptions

InvalidDataException

Archiwum jest zepsute.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

od LZIP(strumień)

Ekstrakty dostarczone archiwum lzip i tworzy Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: archiwum lzip jest w pełni wyodrębnione w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromLZip(string path)

Parameters

path string

Droga do archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Strumień ekstrakcji Lzip nie jest poszukiwany przez naturę algorytmu kompresji. archiwum Tar zapewnia możliwość ekstrakcji arbitralnych rekordów, więc musi działać poszukiwany strumień pod szufladą.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path" znajduje się w nieprawidłowym formacie.

DirectoryNotFoundException

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

FileNotFoundException

Plik nie został znaleziony.

InvalidDataException

Archiwum jest zepsute.

FromXz(Stream)

Ekstrakty dostarczone do archiwum formatu xz i tworzą Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: archiwum xz jest w pełni wyodrębnione w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

Źródło tego archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Archiwum Tar umożliwia wydobycie arbitralnych rekordów, więc musi działać strumień poszukiwany pod szufladą.

FromXz(strumień)

Ekstrakty dostarczone do archiwum formatu xz i tworzą Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: archiwum xz jest w pełni wyodrębnione w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromXz(string path)

Parameters

path string

Droga do archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Archiwum Tar umożliwia wydobycie arbitralnych rekordów, więc musi działać strumień poszukiwany pod szufladą.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path" znajduje się w nieprawidłowym formacie.

DirectoryNotFoundException

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

FileNotFoundException

Plik nie został znaleziony.

od Z(Stream)

Ekstrakty dostarczone do archiwum w formacie Z i tworzą Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: Archiwum Z jest w pełni wyodrębnione w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

Źródło tego archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Archiwum Tar umożliwia wydobycie arbitralnych rekordów, więc musi działać strumień poszukiwany pod szufladą.

od Z(strumień)

Ekstrakty dostarczone do archiwum w formacie Z i tworzą Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: Archiwum Z jest w pełni wyodrębnione w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromZ(string path)

Parameters

path string

Droga do archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Remarks

Archiwum Tar umożliwia wydobycie arbitralnych rekordów, więc musi działać strumień poszukiwany pod szufladą.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path" znajduje się w nieprawidłowym formacie.

DirectoryNotFoundException

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

FileNotFoundException

Plik nie został znaleziony.

FromZstandard(Stream)

Ekstrakty dostarczone Zstandard archiwum i tworzy Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: Zstandardowy archiwum jest w pełni wyodrębnione w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

Źródło tego archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Przepływ Zstandard jest skorumpowany lub nie do czytania.

InvalidDataException

Dane są skorumpowane.

FromZstandard(strumień)

Ekstrakty dostarczone Zstandard archiwum i tworzy Aspose.Zip.Tar.TarArchive z wyciągniętych danych.

Ważne: Zstandardowy archiwum jest w pełni wyodrębnione w ramach tej metody, jego zawartość jest przechowywana wewnętrznie.

public static TarArchive FromZstandard(string path)

Parameters

path string

Droga do archiwum.

Returns

TarArchive

Przykład Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path" znajduje się w nieprawidłowym formacie.

DirectoryNotFoundException

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

FileNotFoundException

Plik nie został znaleziony.

IOException

Przepływ Zstandard jest skorumpowany lub nie do czytania.

InvalidDataException

Dane są skorumpowane.

Save(Stream czy TarFormat?)

Oszczędzaj archiwum na dostarczonym strumieniu.

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

Parameters

output Stream

Przepływ docelowy.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

Examples

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

Remarks

Musi być pisemny.

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(Tłumaczenie, Tłumaczenie ?)

Zapisz archiwum do dostarczonego pliku docelowego.

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

Parameters

destinationFileName string

Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

Examples

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

Remarks

Istnieje możliwość przechowywania archiwum na tę samą ścieżkę, z której został pobrany. jednak nie jest to zalecane, ponieważ ten podejście wykorzystuje kopiowanie do tymczasowego pliku.

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

Określenie destinationFileName’, nazwa pliku, lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach z systemem Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

DirectoryNotFoundException

Określenie destinationFileName’ jest nieważne, (na przykład, jest to na dysku bez mapowania).

IOException

Błąd I/O wystąpił podczas otwierania pliku.

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

Plik nie został znaleziony.

SaveGzipped(Stream czy TarFormat?)

Oszczędza archiwum do strumienia za pomocą kompresji gzip.

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

Parameters

output Stream

Przepływ docelowy.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Musi być pisemny.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Tłumaczenie, Tłumaczenie ?)

Oszczędza archiwum do pliku przez ścieżkę za pomocą kompresji gzip.

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

Parameters

path string

Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub 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

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

DirectoryNotFoundException

Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).

NotSupportedException

path’ is in an invalid format.

SaveLZ4kompresowane(Stream czy TarFormat?)

Oszczędza archiwum do strumienia za pomocą kompresji LZ4.

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

Parameters

output Stream

Przepływ docelowy.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Musi być pisemny.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZ4kompresowane(Tłumaczenie, Tłumaczenie ?)

Oszczędza archiwum do pliku na ścieżkę za pomocą kompresji LZ4.

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

Parameters

path string

Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub 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

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

DirectoryNotFoundException

Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).

NotSupportedException

path’ is in an invalid format.

Przegląd kompresji(Stream czy TarFormat?)

Oszczędza archiwum do strumienia za pomocą kompresji LZMA.

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

Parameters

output Stream

Przepływ docelowy.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Musi być pisemny.

Ważne: archiwum tar jest złożone, a następnie kompresowane w ramach tej metody, jego zawartość jest utrzymywana wewnętrznie.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Przegląd kompresji(Tłumaczenie, Tłumaczenie ?)

Oszczędza archiwum do pliku drogą z kompresją lzma.

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

Parameters

path string

Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Ważne: archiwum tar jest złożone, a następnie kompresowane w ramach tej metody, jego zawartość jest utrzymywana wewnętrznie.

Exceptions

UnauthorizedAccessException

Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub 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

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

DirectoryNotFoundException

Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Stream czy TarFormat?)

Oszczędza archiwum do strumienia za pomocą kompresji lzip.

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

Parameters

output Stream

Przepływ docelowy.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Musi być pisemny.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Tłumaczenie, Tłumaczenie ?)

Oszczędza archiwum do pliku na ścieżkę za pomocą kompresji lzip.

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

Parameters

path string

Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub 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

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

DirectoryNotFoundException

Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Strumień, TarFormat?, XzArchiveSettings)

Oszczędza archiwum do strumienia za pomocą kompresji xz.

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

Parameters

output Stream

Przepływ docelowy.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

settings XzArchiveSettings

Zestaw ustawień określonego archiwum xz: rozmiar słownika, rozmiar bloku, typ sprawdzania.

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

Strumień musi być pisemny.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(strumień, TarFormat?, XzArchiveSettings)

Oszczędza archiwum na ścieżce przez ścieżkę za pomocą kompresji xz.

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

Parameters

path string

Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

settings XzArchiveSettings

Zestaw ustawień określonego archiwum xz: rozmiar słownika, rozmiar bloku, typ sprawdzania.

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

Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub 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

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

DirectoryNotFoundException

Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).

NotSupportedException

path’ is in an invalid format.

SaveZkompresowane(Stream czy TarFormat?)

Oszczędza archiwum do strumienia za pomocą kompresji Z.

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

Parameters

output Stream

Przepływ docelowy.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Musi być pisemny.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZkompresowane(Tłumaczenie, Tłumaczenie ?)

Oszczędza archiwum na ścieżce przez ścieżkę z kompresją Z.

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

Parameters

path string

Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub 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

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

DirectoryNotFoundException

Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Stream czy TarFormat?)

Oszczędza archiwum do strumienia za pomocą kompresji Zstandard.

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

Parameters

output Stream

Przepływ docelowy.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Musi być pisemny.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Tłumaczenie, Tłumaczenie ?)

Oszczędza archiwum do pliku na ścieżkę za pomocą kompresji Zstandard.

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

Parameters

path string

Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.

format TarFormat ?

Definuje format nagłówka tar. wartość zero będzie traktowana jako USTar, gdy to możliwe.

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

Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub 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

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

DirectoryNotFoundException

Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).

NotSupportedException

path’ is in an invalid format.

 Polski