Class TarArchive

Class TarArchive

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

Ta klasa reprezentuje plik archiwum tar. Użyj jej do tworzenia, wyodrębniania lub aktualizacji archiwów tar.

public class TarArchive : IArchive, IDisposable

Dziedziczenie

objectTarArchive

Implementuje

IArchive, IDisposable

Członkowie dziedziczeni

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

Konstruktory

TarArchive()

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

public TarArchive()

Przykłady

W poniższym przykładzie pokazano, jak skompresować 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 mogą być wyodrębnione z archiwum.

public TarArchive(Stream sourceStream)

Parametry

sourceStream Stream

Źródło archiwum. Musi być możliwe do przeszukiwania.

Przykłady

W poniższym przykładzie pokazano, jak wyodrębnić wszystkie wpisy do katalogu.

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

Uwagi

Ten konstruktor nie rozpakowuje żadnego wpisu. Zobacz metodę Aspose.Zip.Tar.TarEntry.Open, aby rozpakować.

Wyjątki

InvalidDataException

sourceStream nie jest możliwe do przeszukiwania.

TarArchive(string)

Inicjalizuje nową instancję klasy Aspose.Zip.Tar.TarArchive i tworzy listę wpisów, które mogą być wyodrębnione z archiwum.

public TarArchive(string path)

Parametry

path string

Ścieżka do pliku archiwum.

Przykłady

W poniższym przykładzie pokazano, jak wyodrębnić wszystkie wpisy do katalogu.

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

Uwagi

Ten konstruktor nie rozpakowuje żadnego wpisu. Zobacz metodę Aspose.Zip.Tar.TarEntry.Open, aby rozpakować.

Wyjątki

ArgumentNullException

path jest null.

SecurityException

Wywołujący nie ma wymaganych uprawnień do dostępu.

ArgumentException

path jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.

UnauthorizedAccessException

Dostęp do pliku path jest zabroniony.

PathTooLongException

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

NotSupportedException

Plik na path zawiera dwukropek (:) w środku ciągu.

FileNotFoundException

Plik nie został znaleziony.

DirectoryNotFoundException

Podana ścieżka jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.

IOException

Plik jest już otwarty.

Właściwości

Entries

Pobiera wpisy typu Aspose.Zip.Tar.TarEntry, które stanowią archiwum.

public ReadOnlyCollection<tarentry> Entries { get; }

Wartość właściwości

ReadOnlyCollection<TarEntry&gt;

Metody

CreateEntries(DirectoryInfo, bool)

Dodaje do archiwum wszystkie pliki i katalogi rekurencyjnie w podanym katalogu.

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

Parametry

directory DirectoryInfo

Katalog do skompresowania.

includeRootDirectory bool

Określa, czy dołączyć sam katalog główny, czy nie.

Zwraca

TarArchive

Archiwum z utworzonymi wpisami.

Przykłady

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)

Dodaje do archiwum wszystkie pliki i katalogi rekurencyjnie w podanym katalogu.

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

Parametry

sourceDirectory string

Katalog do skompresowania.

includeRootDirectory bool

Określa, czy dołączyć sam katalog główny, czy nie.

Zwraca

TarArchive

Archiwum z utworzonymi wpisami.

Przykłady

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

Wyjątki

ArgumentNullException

sourceDirectory jest null.

SecurityException

Wywołujący nie ma wymaganych uprawnień do dostępu do sourceDirectory.

ArgumentException

sourceDirectory zawiera nieprawidłowe znaki, takie jak “, <, > lub |.

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość określoną przez system. Na przykład na platformach opartych na systemie Windows ścieżki muszą być krótsze niż 248 znaków, a nazwy plików muszą być krótsze niż 260 znaków. Podana ścieżka, nazwa pliku lub obie są zbyt długie.

CreateEntry(string, Stream, FileSystemInfo)

Tworzy pojedynczy wpis w archiwum.

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

Parametry

name string

Nazwa wpisu.

source Stream

Strumień wejściowy dla wpisu.

fileInfo FileSystemInfo

Metadane pliku lub folderu do skompresowania.

Zwraca

TarEntry

Instancja wpisu Tar.

Przykłady

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

Uwagi

Nazwa wpisu jest ustawiana wyłącznie w parametrze name. Nazwa pliku podana w parametrze fileInfo nie ma wpływu na nazwę wpisu.

fileInfo może odnosić się do System.IO.DirectoryInfo, jeśli wpis jest katalogiem.

Wyjątki

PathTooLongException

name jest zbyt długie dla tar zgodnie z standardem IEEE 1003.1-1998.

ArgumentException

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

CreateEntry(string, FileInfo, bool)

Tworzy pojedynczy wpis w archiwum.

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

Parametry

name string

Nazwa wpisu.

fileInfo FileInfo

Metadane pliku lub folderu do skompresowania.

openImmediately bool

True, jeśli otworzyć plik natychmiast, w przeciwnym razie otworzyć plik podczas zapisywania archiwum.

Zwraca

TarEntry

Instancja wpisu Tar.

Przykłady

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

Uwagi

Nazwa wpisu jest ustawiana wyłącznie w parametrze name. Nazwa pliku podana w parametrze fileInfo nie ma wpływu na nazwę wpisu.

fileInfo może odnosić się do System.IO.DirectoryInfo, jeśli wpis jest katalogiem.

Jeśli plik jest otwierany natychmiast z parametrem openImmediately, zostaje zablokowany do momentu usunięcia archiwum.

Wyjątki

PathTooLongException

name jest zbyt długie dla tar zgodnie z standardem IEEE 1003.1-1998.

ArgumentException

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

CreateEntry(string, string, bool)

Tworzy pojedynczy wpis w archiwum.

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

Parametry

name string

Nazwa wpisu.

path string

Ścieżka do pliku, który ma być skompresowany.

openImmediately bool

True, jeśli otworzyć plik natychmiast, w przeciwnym razie otworzyć plik podczas zapisywania archiwum.

Zwraca

TarEntry

Instancja wpisu Tar.

Przykłady

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

Uwagi

Nazwa wpisu jest ustawiana wyłącznie w parametrze name. Nazwa pliku podana w parametrze path nie ma wpływu na nazwę wpisu.

Jeśli plik jest otwierany natychmiast z parametrem openImmediately, zostaje zablokowany do momentu usunięcia archiwum.

Wyjątki

ArgumentNullException

path jest null.

SecurityException

Wywołujący nie ma wymaganych uprawnień do dostępu.

ArgumentException

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

UnauthorizedAccessException

Dostęp do pliku path jest zabroniony.

PathTooLongException

Podana path, nazwa pliku lub obie przekraczają maksymalną długość określoną przez system. Na przykład na platformach opartych na systemie Windows ścieżki muszą być krótsze niż 248 znaków, a nazwy plików muszą być krótsze niż 260 znaków. - lub - name jest zbyt długie dla tar zgodnie z standardem IEEE 1003.1-1998.

NotSupportedException

Plik na path zawiera dwukropek (:) w środku ciągu.

DeleteEntry(TarEntry)

Usuwa pierwsze wystąpienie konkretnego wpisu z listy wpisów.

public TarArchive DeleteEntry(TarEntry entry)

Parametry

entry TarEntry

Wpis do usunięcia z listy wpisów.

Zwraca

TarArchive

Archiwum z usuniętym wpisem.

Przykłady

Oto jak można usunąć wszystkie wpisy oprócz ostatniego:

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

DeleteEntry(int)

Usuwa wpis z listy wpisów według indeksu.

public TarArchive DeleteEntry(int entryIndex)

Parametry

entryIndex int

Indeks zerowy wpisu do usunięcia.

Zwraca

TarArchive

Archiwum z usuniętym wpisem.

Przykłady

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

Wyjątki

ArgumentOutOfRangeException

entryIndex jest mniejsze niż 0. - lub - entryIndex jest równe lub większe niż liczba Entries.

Dispose()

Wykonuje zadania zdefiniowane przez aplikację związane z zwalnianiem, uwalnianiem lub resetowaniem zasobów niezarządzanych.

public void Dispose()

Dispose(bool)

Wykonuje zadania zdefiniowane przez aplikację związane z zwalnianiem, uwalnianiem lub resetowaniem zasobów niezarządzanych.

protected virtual void Dispose(bool disposing)

Parametry

disposing bool

Określa, czy zasoby zarządzane powinny być zwolnione.

ExtractToDirectory(string)

Wyodrębnia wszystkie pliki w archiwum do podanego katalogu.

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

Ścieżka do katalogu, w którym mają być umieszczone wyodrębnione pliki.

Przykłady

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

Uwagi

Jeśli katalog nie istnieje, zostanie utworzony.

Wyjątki

ArgumentNullException

path jest null

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość określoną przez system. Na przykład na platformach opartych na systemie Windows ścieżki muszą być krótsze niż 248 znaków, a nazwy plików muszą być krótsze niż 260 znaków.

SecurityException

Wywołujący nie ma wymaganych uprawnień do dostępu do istniejącego katalogu.

NotSupportedException

Jeśli katalog nie istnieje, ścieżka zawiera znak dwukropka (:) nie będący częścią etykiety dysku (“C:").

ArgumentException

Ścieżka jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera jeden lub więcej nieprawidłowych znaków. Możesz zapytać o nieprawidłowe znaki, używając metody System.IO.Path.GetInvalidPathChars. - lub - ścieżka jest prefiksowana lub zawiera tylko znak dwukropka (:).

IOException

Katalog określony przez ścieżkę jest plikiem. - lub - Znana nazwa sieciowa nie jest znana.

FromGZip(Stream)

Wyodrębnia dostarczone archiwum gzip i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum gzip jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromGZip(Stream source)

Parametry

source Stream

Źródło archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Uwagi

Strumień wyodrębniania GZip z natury nie jest możliwy do przeszukiwania. Archiwum Tar zapewnia możliwość wyodrębnienia dowolnego rekordu, więc musi działać na strumieniu możliwym do przeszukiwania “pod maską”.

Wyjątki

InvalidDataException

Archiwum jest uszkodzone.

FromGZip(string)

Wyodrębnia dostarczone archiwum gzip i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum gzip jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromGZip(string path)

Parametry

path string

Ścieżka do pliku archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Uwagi

Strumień wyodrębniania GZip z natury nie jest możliwy do przeszukiwania. Archiwum Tar zapewnia możliwość wyodrębnienia dowolnego rekordu, więc musi działać na strumieniu możliwym do przeszukiwania “pod maską”.

Wyjątki

InvalidDataException

Archiwum jest uszkodzone.

FromLZMA(Stream)

Wyodrębnia dostarczone archiwum LZMA i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum LZMA jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromLZMA(Stream source)

Parametry

source Stream

Źródło archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Uwagi

Strumień wyodrębniania LZMA z natury nie jest możliwy do przeszukiwania. Archiwum Tar zapewnia możliwość wyodrębnienia dowolnego rekordu, więc musi działać na strumieniu możliwym do przeszukiwania “pod maską”.

FromLZMA(string)

Wyodrębnia dostarczone archiwum LZMA i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum LZMA jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromLZMA(string path)

Parametry

path string

Ścieżka do pliku archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Uwagi

Strumień wyodrębniania LZMA z natury nie jest możliwy do przeszukiwania. Archiwum Tar zapewnia możliwość wyodrębnienia dowolnego rekordu, więc musi działać na strumieniu możliwym do przeszukiwania “pod maską”.

FromLZip(Stream)

Wyodrębnia dostarczone archiwum lzip i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum lzip jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromLZip(Stream source)

Parametry

source Stream

Źródło archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Uwagi

Strumień wyodrębniania lzip z natury nie jest możliwy do przeszukiwania. Archiwum Tar zapewnia możliwość wyodrębnienia dowolnego rekordu, więc musi działać na strumieniu możliwym do przeszukiwania “pod maską”.

FromLZip(string)

Wyodrębnia dostarczone archiwum lzip i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum lzip jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromLZip(string path)

Parametry

path string

Ścieżka do pliku archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Uwagi

Strumień wyodrębniania lzip z natury nie jest możliwy do przeszukiwania. Archiwum Tar zapewnia możliwość wyodrębnienia dowolnego rekordu, więc musi działać na strumieniu możliwym do przeszukiwania “pod maską”.

FromXz(Stream)

Wyodrębnia dostarczone archiwum w formacie xz i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum xz jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromXz(Stream source)

Parametry

source Stream

Źródło archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Uwagi

Archiwum Tar zapewnia możliwość wyodrębnienia dowolnego rekordu, więc musi działać na strumieniu możliwym do przeszukiwania “pod maską”.

FromXz(string)

Wyodrębnia dostarczone archiwum w formacie xz i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum xz jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromXz(string path)

Parametry

path string

Ścieżka do pliku archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Uwagi

Archiwum Tar zapewnia możliwość wyodrębnienia dowolnego rekordu, więc musi działać na strumieniu możliwym do przeszukiwania “pod maską”.

FromZ(Stream)

Wyodrębnia dostarczone archiwum w formacie Z i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum Z jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromZ(Stream source)

Parametry

source Stream

Źródło archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Uwagi

Archiwum Tar zapewnia możliwość wyodrębnienia dowolnego rekordu, więc musi działać na strumieniu możliwym do przeszukiwania “pod maską”.

FromZ(string)

Wyodrębnia dostarczone archiwum w formacie Z i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum Z jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromZ(string path)

Parametry

path string

Ścieżka do pliku archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Uwagi

Archiwum Tar zapewnia możliwość wyodrębnienia dowolnego rekordu, więc musi działać na strumieniu możliwym do przeszukiwania “pod maską”.

FromZstandard(Stream)

Wyodrębnia dostarczone archiwum Zstandard i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum Zstandard jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromZstandard(Stream source)

Parametry

source Stream

Źródło archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Wyjątki

IOException

Strumień Zstandard jest uszkodzony lub nieczytelny.

InvalidDataException

Dane są uszkodzone.

FromZstandard(string)

Wyodrębnia dostarczone archiwum Zstandard i tworzy Aspose.Zip.Tar.TarArchive z wyodrębnionych danych.

Uwaga: archiwum Zstandard jest w pełni wyodrębniane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

public static TarArchive FromZstandard(string path)

Parametry

path string

Ścieżka do pliku archiwum.

Zwraca

TarArchive

Instancja Aspose.Zip.Tar.TarArchive

Wyjątki

IOException

Strumień Zstandard jest uszkodzony lub nieczytelny.

InvalidDataException

Dane są uszkodzone.

Save(Stream, TarFormat?)

Zapisuje archiwum do podanego strumienia.

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

Parametry

output Stream

Strumień docelowy.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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

Uwagi

output musi być zapisywalny.

Wyjątki

ArgumentException

output nie jest zapisywalny. - lub - output jest tym samym strumieniem, z którego wyodrębniamy. - LUB - Nie można zapisać archiwum w format z powodu ograniczeń formatu.

Save(string, TarFormat?)

Zapisuje archiwum do podanego pliku docelowego.

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

Parametry

destinationFileName string

Ścieżka archiwum, które ma być utworzone. Jeśli podana nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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

Uwagi

Możliwe jest zapisanie archiwum w tej samej ścieżce, z której zostało załadowane. Jednak nie jest to zalecane, ponieważ podejście to wykorzystuje kopiowanie do pliku tymczasowego.

Wyjątki

ArgumentException

destinationFileName jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera jeden lub więcej nieprawidłowych znaków zdefiniowanych przez System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName jest null.

PathTooLongException

Podana destinationFileName, nazwa pliku lub obie przekraczają maksymalną długość określoną przez system. Na przykład na platformach opartych na systemie Windows ścieżki muszą być krótsze niż 248 znaków, a nazwy plików muszą być krótsze niż 260 znaków.

DirectoryNotFoundException

Podana destinationFileName jest nieprawidłowa (na przykład znajduje się na nieprzypisanym dysku).

IOException

Wystąpił błąd I/O podczas otwierania pliku.

UnauthorizedAccessException

destinationFileName wskazuje na plik tylko do odczytu, a dostęp nie jest do odczytu. - lub - ścieżka wskazuje na katalog. - lub - Wywołujący nie ma wymaganych uprawnień.

NotSupportedException

destinationFileName jest w nieprawidłowym formacie.

FileNotFoundException

Plik nie został znaleziony.

SaveGzipped(Stream, TarFormat?)

Zapisuje archiwum do strumienia z kompresją gzip.

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

Parametry

output Stream

Strumień docelowy.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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

Uwagi

output musi być zapisywalny.

Wyjątki

ArgumentNullException

output jest null.

ArgumentException

output nie jest zapisywalny.

SaveGzipped(string, TarFormat?)

Zapisuje archiwum do pliku według ścieżki z kompresją gzip.

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

Parametry

path string

Ścieżka archiwum, które ma być utworzone. Jeśli podana nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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

Zapisuje archiwum do strumienia z kompresją LZMA.

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

Parametry

output Stream

Strumień docelowy.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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

Uwagi

output musi być zapisywalny.

Uwaga: archiwum tar jest tworzone, a następnie kompresowane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

Wyjątki

ArgumentNullException

output jest null.

ArgumentException

output nie jest zapisywalny.

SaveLZMACompressed(string, TarFormat?)

Zapisuje archiwum do pliku według ścieżki z kompresją lzma.

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

Parametry

path string

Ścieżka archiwum, które ma być utworzone. Jeśli podana nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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

Uwagi

Uwaga: archiwum tar jest tworzone, a następnie kompresowane w tej metodzie, jego zawartość jest przechowywana wewnętrznie. Uważaj na zużycie pamięci.

SaveLzipped(Stream, TarFormat?)

Zapisuje archiwum do strumienia z kompresją lzip.

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

Parametry

output Stream

Strumień docelowy.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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

Uwagi

output musi być zapisywalny.

Wyjątki

ArgumentNullException

output jest null.

ArgumentException

output nie jest zapisywalny.

SaveLzipped(string, TarFormat?)

Zapisuje archiwum do pliku według ścieżki z kompresją lzip.

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

Parametry

path string

Ścieżka archiwum, które ma być utworzone. Jeśli podana nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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)

Zapisuje archiwum do strumienia z kompresją xz.

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

Parametry

output Stream

Strumień docelowy.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

settings XzArchiveSettings

Zestaw ustawień dla konkretnego archiwum xz: rozmiar słownika, rozmiar bloku, typ sprawdzenia.

Przykłady

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

Uwagi

output musi być zapisywalny.

Wyjątki

ArgumentNullException

output jest null.

ArgumentException

output nie jest zapisywalny.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

Zapisuje archiwum do pliku według ścieżki z kompresją xz.

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

Parametry

path string

Ścieżka archiwum, które ma być utworzone. Jeśli podana nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

settings XzArchiveSettings

Zestaw ustawień dla konkretnego archiwum xz: rozmiar słownika, rozmiar bloku, typ sprawdzenia.

Przykłady

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

Zapisuje archiwum do strumienia z kompresją Z.

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

Parametry

output Stream

Strumień docelowy.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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

Uwagi

output musi być zapisywalny.

Wyjątki

ArgumentNullException

output jest null.

ArgumentException

output nie jest zapisywalny.

SaveZCompressed(string, TarFormat?)

Zapisuje archiwum do pliku według ścieżki z kompresją Z.

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

Parametry

path string

Ścieżka archiwum, które ma być utworzone. Jeśli podana nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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

Zapisuje archiwum do strumienia z kompresją Zstandard.

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

Parametry

output Stream

Strumień docelowy.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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

Uwagi

output musi być zapisywalny.

Wyjątki

ArgumentNullException

output jest null.

ArgumentException

output nie jest zapisywalny.

SaveZstandard(string, TarFormat?)

Zapisuje archiwum do pliku według ścieżki z kompresją Zstandard.

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

Parametry

path string

Ścieżka archiwum, które ma być utworzone. Jeśli podana nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.

format TarFormat?

Określa format nagłówka tar. Wartość null będzie traktowana jako USTar, gdy to możliwe.

Przykłady

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