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
Implementuje
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
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
path
jest null.
Wywołujący nie ma wymaganych uprawnień do dostępu.
path
jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.
Dostęp do pliku path
jest zabroniony.
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.
Plik na path
zawiera dwukropek (:) w środku ciągu.
Plik nie został znaleziony.
Podana ścieżka jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.
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>
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
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
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
sourceDirectory
jest null.
Wywołujący nie ma wymaganych uprawnień do dostępu do sourceDirectory
.
sourceDirectory
zawiera nieprawidłowe znaki, takie jak “, <, > lub |.
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
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
name
jest zbyt długie dla tar zgodnie z standardem IEEE 1003.1-1998.
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
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
name
jest zbyt długie dla tar zgodnie z standardem IEEE 1003.1-1998.
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
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
path
jest null.
Wywołujący nie ma wymaganych uprawnień do dostępu.
path
jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki. - lub - Nazwa pliku, jako część name
, przekracza 100 symboli.
Dostęp do pliku path
jest zabroniony.
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.
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
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 > 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
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
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
path jest null
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.
Wywołujący nie ma wymaganych uprawnień do dostępu do istniejącego katalogu.
Jeśli katalog nie istnieje, ścieżka zawiera znak dwukropka (:) nie będący częścią etykiety dysku (“C:").
Ś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 (:).
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
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
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
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
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
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
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
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
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
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
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
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
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
Instancja Aspose.Zip.Tar.TarArchive
Wyjątki
Strumień Zstandard jest uszkodzony lub nieczytelny.
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
Instancja Aspose.Zip.Tar.TarArchive
Wyjątki
Strumień Zstandard jest uszkodzony lub nieczytelny.
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
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
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.
destinationFileName
jest null.
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.
Podana destinationFileName
jest nieprawidłowa (na przykład znajduje się na nieprzypisanym dysku).
Wystąpił błąd I/O podczas otwierania pliku.
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ń.
destinationFileName
jest w nieprawidłowym formacie.
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
output
jest null.
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.
Wyjątki
output
jest null.
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
output
jest null.
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
output
jest null.
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
output
jest null.
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
output
jest null.
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");
}
}