Class XzArchive

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

object XzArchive

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

ArgumentException

source’ is not seekable.

ArgumentNullException

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

ArgumentNullException

path’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp.

ArgumentException

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

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

Plik nie został znaleziony.

DirectoryNotFoundException

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

IOException

Archiwum jest już otwarte.

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

InvalidOperationException

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

InvalidOperationException

Archiwum i informacje o usługach nie zostały przeczytane.

SecurityException

Wzywacz nie ma wymaganej zgody na otwarcie fileInfo'.

ArgumentException

Droga pliku jest pusta lub zawiera tylko białe przestrzenie.

FileNotFoundException

Plik nie został znaleziony.

UnauthorizedAccessException

Ścieżka do pliku jest czytana tylko lub jest katalogu.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

FileInfo

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

InvalidOperationException

Archiwum i informacje o usługach nie zostały przeczytane.

ArgumentNullException

path’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp.

ArgumentException

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

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

Plik nie został znaleziony.

DirectoryNotFoundException

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

IOException

Archiwum jest już otwarte.

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

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

ArgumentException

output’ does not support seeking.

ArgumentNullException

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

ArgumentNullException

destinationFileName’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp.

ArgumentException

destinationFileName’ jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku destinationFileName’ jest odrzucony.

PathTooLongException

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

NotSupportedException

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

ArgumentException

Ź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

SecurityException

Wzywacz nie ma wymaganej zgody na otwarcie fileInfo'.

ArgumentException

Droga pliku jest pusta lub zawiera tylko białe przestrzenie.

FileNotFoundException

Plik nie został znaleziony.

UnauthorizedAccessException

Ścieżka do pliku jest czytana tylko lub jest katalogu.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

ArgumentNullException

sourcePath’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp.

ArgumentException

sourcePath’ jest pusty, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku sourcePath’ jest odrzucony.

PathTooLongException

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.

NotSupportedException

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

 Polski