Class SnappyArchive
Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)
Ta klasa reprezentuje plik archiwum snappy. Użyj jej do tworzenia lub wyodrębniania archiwów snappy.
public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry
Dziedziczenie
Implementuje
IArchive, IDisposable, IArchiveFileEntry
Dziedziczone członkowie
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktorzy
SnappyArchive()
Inicjalizuje nową instancję klasy Aspose.Zip.Snappy.SnappyArchive przygotowaną do kompresji.
public SnappyArchive()
Przykłady
Poniższy przykład pokazuje, jak skompresować plik.
using (SnappyArchive archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.snapy");
}
SnappyArchive(Stream)
Inicjalizuje nową instancję klasy Aspose.Zip.Snappy.SnappyArchive przygotowaną do dekompresji.
public SnappyArchive(Stream source)
Parametry
source
Stream
Źródło archiwum.
Uwagi
Ten konstruktor nie dekompresuje. Zobacz metodę Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) do dekompresji.
Wyjątki
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.
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.
Błąd w danych w nagłówku lub sumie kontrolnej.
Strumień docelowy jest null.
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.
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
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.
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.
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.
Plik na sourcePath
zawiera dwukropek (:) w środku ciągu.