Class LzmaArchive

Class LzmaArchive

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

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

public class LzmaArchive : IArchive, IDisposable, IArchiveFileEntry

Dziedziczenie

objectLzmaArchive

Implementuje

IArchive, IDisposable, IArchiveFileEntry

Członkowie dziedziczeni

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

Konstruktorzy

LzmaArchive(LzmaArchiveSettings)

Inicjalizuje nową instancję klasy Aspose.Zip.LZMA.LzmaArchive i tworzy archiwum w formacie lzma.

public LzmaArchive(LzmaArchiveSettings settings = null)

Parametry

settings LzmaArchiveSettings

Zestaw ustawień dla konkretnego archiwum lzma.

LzmaArchive(Stream)

Inicjalizuje nową instancję klasy Aspose.Zip.LZMA.LzmaArchive przygotowaną do dekompresji.

public LzmaArchive(Stream source)

Parametry

source Stream

Źródło archiwum.

Uwagi

Ten konstruktor nie dekompresuje. Zobacz metodę Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) w celu dekompresji.

Wyjątki

ArgumentException

source nie jest możliwe do przeszukiwania.

ArgumentNullException

source jest null.

LzmaArchive(string)

Inicjalizuje nową instancję klasy Aspose.Zip.LZMA.LzmaArchive przygotowaną do dekompresji.

public LzmaArchive(string path)

Parametry

path string

Ścieżka do źródła archiwum.

Przykłady

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new LzmaArchive(sourceLzmaFile))
    {
         archive.Extract(extractedFile);
    }
}

Uwagi

Ten konstruktor nie dekompresuje. Zobacz metodę Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) w celu dekompresji.

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

Określona path, nazwa pliku lub oba przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.

NotSupportedException

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

Metody

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

Parametry

disposing bool

Czy zasoby zarządzane powinny być zwalniane.

Extract(Stream)

Wyodrębnia archiwum lzma do strumienia.

public void Extract(Stream destination)

Parametry

destination Stream

Strumień do przechowywania zdekompresowanych danych.

Przykłady

using (FileStream sourceLzmaFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
       using (var archive = new LzmaArchive(sourceLzmaFile))
       {
           archive.Extract(extractedFile);
       }
   }
}

Wyjątki

InvalidOperationException

Nagłówki archiwum i informacje serwisowe nie zostały odczytane.

InvalidDataException

Archiwum jest uszkodzone.

ArgumentNullException

Strumień docelowy jest null.

ArgumentException

Strumień docelowy nie obsługuje zapisu.

Extract(FileInfo)

Wyodrębnia archiwum lzma do pliku.

public void Extract(FileInfo fileInfo)

Parametry

fileInfo FileInfo

FileInfo do przechowywania zdekompresowanych danych.

Przykłady

using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzmaArchive(lzmaFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Wyjątki

InvalidOperationException

Nagłówki archiwum i informacje serwisowe nie zostały odczytane.

SecurityException

Wywołujący nie ma wymaganych uprawnień do otwarcia fileInfo.

ArgumentException

Ścieżka pliku jest pusta lub zawiera tylko białe znaki.

FileNotFoundException

Plik nie został znaleziony.

UnauthorizedAccessException

Ścieżka do pliku jest tylko do odczytu lub jest katalogiem.

ArgumentNullException

fileInfo jest null.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa, na przykład jest na nieprzypisanym dysku.

IOException

Plik jest już otwarty.

InvalidDataException

Archiwum jest uszkodzone.

Extract(string)

Wyodrębnia archiwum lzma do pliku według ścieżki.

public void Extract(string path)

Parametry

path string

Ścieżka do pliku, który będzie przechowywał zdekompresowane dane.

Przykłady

using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzmaArchive(lzmaFile))
    {
        archive.Extract("extracted.bin");
    }
}

Wyjątki

InvalidOperationException

Nagłówki archiwum i informacje serwisowe nie zostały odczytane.

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

Określona path, nazwa pliku lub oba przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.

NotSupportedException

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

InvalidDataException

Archiwum jest uszkodzone.

ExtractToDirectory(string)

Wyodrębnia zawartość archiwum do podanego katalogu.

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

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

Uwagi

Jeśli katalog nie istnieje, zostanie utworzony.

Wyjątki

ArgumentNullException

destinationDirectory jest null.

PathTooLongException

Określona ścieżka, nazwa pliku lub oba przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej 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 (:) który nie jest częścią etykiety dysku (“C:").

ArgumentException

destinationDirectory jest zerowym ciągiem, zawiera tylko białe znaki lub zawiera jeden lub więcej nieprawidłowych znaków. Możesz sprawdzić nieprawidłowe znaki, używając metody System.IO.Path.GetInvalidPathChars. -lub- ścieżka jest poprzedzona lub zawiera tylko znak dwukropka (:).

IOException

Katalog określony przez ścieżkę jest plikiem. -lub- Nazwa sieci nie jest znana.

InvalidDataException

Archiwum jest uszkodzone.

Save(Stream)

Zapisuje archiwum lzma do podanego strumienia.

public void Save(Stream output)

Parametry

output Stream

Strumień docelowy.

Przykłady

using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
    using (var archive = new LzmaArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzmaFile);
     }
}

Uwagi

output musi być możliwe do przeszukiwania.

Wyjątki

ArgumentException

output nie obsługuje przeszukiwania.

ArgumentNullException

output jest null.

Save(FileInfo)

Zapisuje archiwum lzma do podanego pliku docelowego.

public void Save(FileInfo destination)

Parametry

destination FileInfo

FileInfo, który zostanie otwarty jako strumień docelowy.

Przykłady

using (var archive = new LzmaArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.lzma"));
}

Wyjątki

SecurityException

Wywołujący nie ma wymaganych uprawnień do otwarcia destination.

ArgumentException

Ścieżka pliku jest pusta lub zawiera tylko białe znaki.

FileNotFoundException

Plik nie został znaleziony.

UnauthorizedAccessException

Ścieżka do pliku jest tylko do odczytu lub jest katalogiem.

ArgumentNullException

destination jest null.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa, na przykład jest na nieprzypisanym dysku.

IOException

Plik jest już otwarty.

Save(string)

Zapisuje archiwum lzma do podanego pliku docelowego.

public void Save(string destinationFileName)

Parametry

destinationFileName string

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

Przykłady

using (var archive = new LzmaArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.lzma");
}

Wyjątki

ArgumentNullException

destinationFileName jest null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Dostęp do pliku destinationFileName jest zabroniony.

PathTooLongException

Określona destinationFileName, nazwa pliku lub oba przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.

NotSupportedException

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

SetSource(Stream)

Ustawia zawartość do skompresowania w archiwum.

public void SetSource(Stream source)

Parametry

source Stream

Strumień wejściowy dla archiwum.

Przykłady

using (var archive = new LzmaArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.lzma");
}

Wyjątki

ArgumentException

Strumień source jest nieprzeszukiwalny.

SetSource(FileInfo)

Ustawia zawartość do skompresowania w archiwum.

public void SetSource(FileInfo fileInfo)

Parametry

fileInfo FileInfo

FileInfo, który zostanie otwarty jako strumień wejściowy.

Przykłady

using (var archive = new LzmaArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.lzma");
}

Wyjątki

SecurityException

Wywołujący nie ma wymaganych uprawnień do otwarcia fileInfo.

ArgumentException

Ścieżka pliku jest pusta lub zawiera tylko białe znaki.

FileNotFoundException

Plik nie został znaleziony.

UnauthorizedAccessException

Ścieżka do pliku jest tylko do odczytu lub jest katalogiem.

ArgumentNullException

fileInfo jest null.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa, na przykład jest na nieprzypisanym dysku.

IOException

Plik jest już otwarty.

SetSource(string)

Ustawia zawartość do skompresowania w archiwum.

public void SetSource(string sourcePath)

Parametry

sourcePath string

Ścieżka do pliku, który zostanie otwarty jako strumień wejściowy.

Przykłady

using (var archive = new LzmaArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.lzma");
}

Wyjątki

ArgumentNullException

sourcePath jest null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Dostęp do pliku sourcePath jest zabroniony.

PathTooLongException

Określona sourcePath, nazwa pliku lub oba przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.

NotSupportedException

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

 Polski