Class SnappyArchive

source nie jest możliwe do przeszukiwania.

source jest null.

SnappyArchive(string)

Inicjalizuje nową instancję klasy Aspose.Zip.Snappy.SnappyArchive przygotowaną do dekompresji.

public SnappyArchive(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 SnappyArchive(sourceSnappyFile))
    {
         archive.Extract(extractedFile);
    }
   }

Uwagi

Ten konstruktor nie dekompresuje. Zobacz metodę Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) do dekompresji.

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.

Określona path, nazwa pliku, lub obie 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.

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

Plik nie został znaleziony.

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

InvalidOperationException

Plik jest już otwarty.

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 zarządzane zasoby powinny być zwolnione.

Extract(Stream)

Wyodrębnia archiwum snappy do strumienia.

public void Extract(Stream destination)

Parametry

destination Stream

Strumień do przechowywania zdekompresowanych danych.

Przykłady

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

Wyjątki

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

InvalidDataException

Błąd w danych w nagłówku lub sumie kontrolnej.

Strumień docelowy jest null.

InvalidOperationException

Strumień docelowy nie obsługuje zapisu.

Extract(FileInfo)

Wyodrębnia archiwum snappy do pliku.

public void Extract(FileInfo fileInfo)

Parametry

fileInfo FileInfo

FileInfo do przechowywania zdekompresowanych danych.

Przykłady

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

Wyjątki

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

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

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

Plik nie został znaleziony.

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

fileInfo jest null.

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

InvalidOperationException

Plik jest już otwarty.

Extract(string)

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

public FileInfo Extract(string path)

Parametry

path string

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

Zwraca

FileInfo

Instancja System.IO.FileInfo zawierająca wyodrębnione dane.

Przykłady

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

Wyjątki

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

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.

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

ExtractToDirectory(string)

Wyodrębnia zawartość archiwum do podanego katalogu.

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

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

Uwagi

Jeśli katalog nie istnieje, zostanie utworzony.

Wyjątki

destinationDirectory jest null.

Określona ścieżka, nazwa pliku, lub obie 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.

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

Jeśli katalog nie istnieje, ścieżka zawiera znak dwukropka (:) który nie jest częścią etykiety dysku (“C:").

destinationDirectory 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 sprawdzić 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- Nazwa sieci nie jest znana.

Save(Stream)

Zapisuje archiwum snappy do podanego strumienia.

public void Save(Stream output)

Parametry

output Stream

Strumień docelowy.

Przykłady

using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
    using (var archive = new SnappyArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(snappyFile);
     }
}

Uwagi

output musi być możliwy do przeszukiwania.

Wyjątki

output nie obsługuje przeszukiwania.

output jest null.

Save(FileInfo)

Zapisuje archiwum snappy 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 SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.snappy"));
}

Wyjątki

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

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

Plik nie został znaleziony.

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

destination jest null.

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

Plik jest już otwarty.

Save(string)

Zapisuje archiwum snappy do podanego pliku docelowego.

public void Save(string destinationFileName)

Parametry

destinationFileName string

Ścieżka archiwum do utworzenia. Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.

Przykłady

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

Wyjątki

destinationFileName jest null.

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

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

Dostęp do pliku destinationFileName jest zabroniony.

Określona destinationFileName, nazwa pliku, lub obie 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.

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

SetSource(Stream)

Ustawia zawartość, która ma być skompresowana w archiwum.

public void SetSource(Stream source)

Parametry

source Stream

Strumień wejściowy dla archiwum.

Przykłady

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

Wyjątki

Strumień source jest nieprzeszukiwany.

SetSource(FileInfo)

Ustawia zawartość, która ma być skompresowana 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 SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.snappy");
}

Wyjątki

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

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

Plik nie został znaleziony.

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

fileInfo jest null.

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

Plik jest już otwarty.

SetSource(string)

Ustawia zawartość, która ma być skompresowana 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 SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snappy");
}

Wyjątki

sourcePath jest null.

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

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

Dostęp do pliku sourcePath jest zabroniony.

Określona sourcePath, nazwa pliku, lub obie 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.