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
Implements
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
sourceStream’ is not seekable.
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
path’ is null.
Klient nie posiada wymaganego zezwolenia na dostęp.
Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku path" jest odrzucony.
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.
Plik w path’ zawiera kolumnę (:) w środku paska.
Plik nie został znaleziony.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
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
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
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
sourceDirectory’ is null.
Wzywacz nie ma wymaganej zgody na dostęp do sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
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
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
name’ is too long for tar as of IEEE 1003.1-1998 standard.
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
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
name’ is too long for tar as of IEEE 1003.1-1998 standard.
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
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
path’ is null.
Klient nie posiada wymaganego zezwolenia na dostęp.
path’ jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky. - lub - Nazwa pliku, jako część
name’, przekracza 100 symboli.
Dostęp do pliku path" jest odrzucony.
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.
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
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 > 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
Archiwum z wpisem usunięte.
Examples
using (var archive = new TarArchive("two_files.tar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.tar");
}
Exceptions
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
Droga jest zero
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.
Odwołujący nie posiada wymaganej pozwolenia na dostęp do istniejącego katalogu.
Jeśli dyrektywa nie istnieje, ścieżka zawiera znak kolumny (:) który nie jest częścią etykiety napędu (“C:”).
Ś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 (:).
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
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
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
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
path’ is null.
Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku path" jest odrzucony.
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.
Plik w path" znajduje się w nieprawidłowym formacie.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
Plik nie został znaleziony.
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
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
path’ is null.
Klient nie posiada wymaganego zezwolenia na dostęp
Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku path" jest odrzucony.
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.
Plik w path" znajduje się w nieprawidłowym formacie.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
Plik nie został znaleziony.
Plik jest zbyt krótki.
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
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
Nie można przeczytać z source’
source’ is null.
source’ is too short.
Ź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
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
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
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
path’ is null.
Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku path" jest odrzucony.
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.
Plik w path" znajduje się w nieprawidłowym formacie.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
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
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
Archiwum jest zepsute.
source’ is not seekable.
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
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
path’ is null.
Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku path" jest odrzucony.
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.
Plik w path" znajduje się w nieprawidłowym formacie.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
Plik nie został znaleziony.
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
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
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
path’ is null.
Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku path" jest odrzucony.
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.
Plik w path" znajduje się w nieprawidłowym formacie.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
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
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
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
path’ is null.
Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku path" jest odrzucony.
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.
Plik w path" znajduje się w nieprawidłowym formacie.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
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
Przykład Aspose.Zip.Tar.TarArchive
Exceptions
Przepływ Zstandard jest skorumpowany lub nie do czytania.
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
Przykład Aspose.Zip.Tar.TarArchive
Exceptions
path’ is null.
Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku path" jest odrzucony.
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.
Plik w path" znajduje się w nieprawidłowym formacie.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
Plik nie został znaleziony.
Przepływ Zstandard jest skorumpowany lub nie do czytania.
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
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
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
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.
Określenie destinationFileName’ jest nieważne, (na przykład, jest to na dysku bez mapowania).
Błąd I/O wystąpił podczas otwierania pliku.
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.
destinationFileName’ is in an invalid format.
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
output’ is null.
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
Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).
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
output’ is null.
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
Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).
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
output’ is null.
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
Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).
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
output’ is null.
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
Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).
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
output’ is null.
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
Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).
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
output’ is null.
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
Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).
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
output’ is null.
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
Wzywacz nie ma wymaganej zgody. -or- path’ określony tylko czytany plik lub katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Określenie path’ jest nieważne (na przykład znajduje się na dysku bez mapowania).
path’ is in an invalid format.