Class XzArchive
Nazwa przestrzeń: Aspose.Zip.Xz Zestawienie: Aspose.Zip.dll (25.5.0)
Ta klasa reprezentuje plik archiwum xz. Użyj go do tworzenia i ekstrakcji plików archiwum xz.
public class XzArchive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Dziedziczeni członkowie
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
XzArchive(XzArchiveSettings)
Inicjalizuje nowy przykład klasy Aspose.Zip.Xz.XzArchive i tworzy archiwum w formacie xz.
public XzArchive(XzArchiveSettings settings = null)
Parameters
settings
XzArchiveSettings
Zestaw ustawień określonego archiwum xz: rozmiar słownika, rozmiar bloku, typ sprawdzania.
XzArchive(Stream)
Inicjalizuje nową instancję klasy Aspose.Zip.Xz.XzArchive przygotowanej do dekompresji.
public XzArchive(Stream source)
Parameters
source
Stream
Źródło tego archiwum.
Remarks
Konstruktor ten nie dekompresuje. zobacz Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) metoda dekompresji.
Exceptions
source’ is not seekable.
source’ is null.
XzArchive(strumień)
Inicjalizuje nową instancję klasy Aspose.Zip.Xz.XzArchive przygotowanej do dekompresji.
public XzArchive(string path)
Parameters
path
string
Droga do źródła archiwum.
Remarks
Konstruktor ten nie dekompresuje. zobacz Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) metoda dekompresji.
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.
Methods
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?
Extract(Stream)
Wyciągnij archiwum xz do strumienia.
public void Extract(Stream destination)
Parameters
destination
Stream
Przepływ do przechowywania dekompresowanych danych.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(extractedFile);
}
}
}
Exceptions
Archiwum i informacje o usługach nie zostały przeczytane.
Extract(FileInfo)
Wyciągnij archiwum xz do pliku.
public void Extract(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo do przechowywania dekompresowanych danych.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Exceptions
Archiwum i informacje o usługach nie zostały przeczytane.
Wzywacz nie ma wymaganej zgody na otwarcie fileInfo'.
Droga pliku jest pusta lub zawiera tylko białe przestrzenie.
Plik nie został znaleziony.
Ścieżka do pliku jest czytana tylko lub jest katalogu.
fileInfo’ is null.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
Archiwum jest już otwarte.
Extract(strumień)
Ekstrakcja archiwum xz do pliku przez ścieżkę.
public FileInfo Extract(string path)
Parameters
path
string
Ścieżka do pliku, który przechowuje dekompresowane dane.
Returns
System.IO.FileInfo instancja zawierająca wydane dane.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}
Exceptions
Archiwum i informacje o usługach nie zostały przeczytane.
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.
ExtractToDirectory(strumień)
Wyciąga treść archiwum do dostarczonego katalogu.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
Droga do katalogu, aby umieścić wyciągnięte pliki.
Remarks
Jeśli dyrektywa nie istnieje, zostanie ona utworzona.
Exceptions
destinationDirectory’ is null.
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:”).
destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).
Dyskusja określona przez ścieżkę jest plikiem. -or- Nazwa sieci nie jest znana.
Save(Stream)
Oszczędza archiwum xz do dostarczonego przepływu.
public void Save(Stream output)
Parameters
output
Stream
Przepływ docelowy.
Examples
using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save(xzFile);
}
}
Remarks
Musi być poszukiwana.
Exceptions
output’ does not support seeking.
output’ is null.
Save(strumień)
Oszczędza archiwum xz do dostarczonego pliku docelowego.
public void Save(string destinationFileName)
Parameters
destinationFileName
string
Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.xz");
}
Exceptions
destinationFileName’ is null.
Klient nie posiada wymaganego zezwolenia na dostęp.
destinationFileName’ jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku destinationFileName’ jest odrzucony.
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.
Plik w adresie destinationFileName’ zawiera kolumnę (:) w środku paska.
SetSource(Stream)
Ustaw zawartość do kompresji w archiwum.
public void SetSource(Stream source)
Parameters
source
Stream
Przepływ wejściowy do archiwum.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}
Exceptions
Źródło Źródło Źródło Źródło Źródło Źródło Źródło Źródło Źródło
SetSource(FileInfo)
Ustaw zawartość do kompresji w archiwum.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo, który zostanie otwarty jako strumień wejściowy.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.xz");
}
Exceptions
Wzywacz nie ma wymaganej zgody na otwarcie fileInfo'.
Droga pliku jest pusta lub zawiera tylko białe przestrzenie.
Plik nie został znaleziony.
Ścieżka do pliku jest czytana tylko lub jest katalogu.
fileInfo’ is null.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
Archiwum jest już otwarte.
SetSource(strumień)
Ustaw zawartość do kompresji w archiwum.
public void SetSource(string sourcePath)
Parameters
sourcePath
string
Droga do pliku, który zostanie otwarty jako strumień wejściowy.
Examples
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}
Exceptions
sourcePath’ is null.
Klient nie posiada wymaganego zezwolenia na dostęp.
sourcePath’ jest pusty, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku sourcePath’ jest odrzucony.
Podany sourcePath’, 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 pliku muszą być mniejsze niż 260 znaków.
Plik w sourcePath’ zawiera kolumnę (:) w środku paska.