Class SnappyArchive
Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)
Tato třída reprezentuje soubor snappy archivu. Použijte ji k sestavení nebo extrakci snappy archivů.
public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry
Dědičnost
Implementuje
IArchive, IDisposable, IArchiveFileEntry
Děděné členy
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktor
SnappyArchive()
Inicializuje novou instanci třídy Aspose.Zip.Snappy.SnappyArchive připravenou pro kompresi.
public SnappyArchive()
Příklady
Následující příklad ukazuje, jak zkomprimovat soubor.
using (SnappyArchive archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.snapy");
}
SnappyArchive(Stream)
Inicializuje novou instanci třídy Aspose.Zip.Snappy.SnappyArchive připravenou pro dekompresi.
public SnappyArchive(Stream source)
Parametry
source
Stream
Zdroj archivu.
Poznámky
Tento konstruktor neprovádí dekompresi. Viz metoda Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) pro dekompresi.
Výjimky
source
není možné procházet.
source
je null.
SnappyArchive(string)
Inicializuje novou instanci třídy Aspose.Zip.Snappy.SnappyArchive připravenou pro dekompresi.
public SnappyArchive(string path)
Parametry
path
string
Cesta k zdroji archivu.
Příklady
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new SnappyArchive(sourceSnappyFile))
{
archive.Extract(extractedFile);
}
}
Poznámky
Tento konstruktor neprovádí dekompresi. Viz metoda Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) pro dekompresi.
Výjimky
path
je null.
Volající nemá potřebná oprávnění pro přístup.
path
je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.
Přístup k souboru path
je odepřen.
Zadaná path
, název souboru nebo obojí překračuje maximální délku definovanou systémem. Například na platformách Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.
Soubor na path
obsahuje dvojtečku (:) uprostřed řetězce.
Soubor nebyl nalezen.
Zadaná cesta je neplatná, například je na nepřiřazeném disku.
Soubor je již otevřen.
Metody
Dispose()
Provádí úkoly definované aplikací spojené s uvolněním, uvolněním nebo resetováním neřízených prostředků.
public void Dispose()
Dispose(bool)
Provádí úkoly definované aplikací spojené s uvolněním, uvolněním nebo resetováním neřízených prostředků.
protected virtual void Dispose(bool disposing)
Parametry
disposing
bool
Zda by měly být uvolněny řízené prostředky.
Extract(Stream)
Extrahuje snappy archiv do proudu.
public void Extract(Stream destination)
Parametry
destination
Stream
Proud pro ukládání dekomprimovaných dat.
Příklady
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);
}
}
}
Výjimky
Hlavičky archivu a informace o službách nebyly přečteny.
Chyba v datech v hlavičce nebo kontrolním součtu.
Cílový proud je null.
Cílový proud nepodporuje zápis.
Extract(FileInfo)
Extrahuje snappy archiv do souboru.
public void Extract(FileInfo fileInfo)
Parametry
fileInfo
FileInfo
FileInfo pro ukládání dekomprimovaných dat.
Příklady
using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new SnappyArchive(snappyFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Výjimky
Hlavičky archivu a informace o službách nebyly přečteny.
Volající nemá potřebná oprávnění pro otevření fileInfo
.
Cesta k souboru je prázdná nebo obsahuje pouze bílé znaky.
Soubor nebyl nalezen.
Cesta k souboru je pouze pro čtení nebo je to adresář.
fileInfo
je null.
Zadaná cesta je neplatná, například je na nepřiřazeném disku.
Soubor je již otevřen.
Extract(string)
Extrahuje snappy archiv do souboru podle cesty.
public FileInfo Extract(string path)
Parametry
path
string
Cesta k souboru, který bude ukládat dekomprimovaná data.
Vrací
Instance System.IO.FileInfo obsahující extrahovaná data.
Příklady
using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new SnappyArchive(snappyFile))
{
archive.Extract("extracted.bin");
}
}
Výjimky
Hlavičky archivu a informace o službách nebyly přečteny.
path
je null.
Volající nemá potřebná oprávnění pro přístup.
path
je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.
Přístup k souboru path
je odepřen.
Zadaná path
, název souboru nebo obojí překračuje maximální délku definovanou systémem. Například na platformách Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.
Soubor na path
obsahuje dvojtečku (:) uprostřed řetězce.
ExtractToDirectory(string)
Extrahuje obsah archivu do zadaného adresáře.
public void ExtractToDirectory(string destinationDirectory)
Parametry
destinationDirectory
string
Cesta k adresáři, do kterého budou umístěny extrahované soubory.
Poznámky
Pokud adresář neexistuje, bude vytvořen.
Výjimky
destinationDirectory
je null.
Zadaná cesta, název souboru nebo obojí překračuje maximální délku definovanou systémem. Například na platformách Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.
Volající nemá potřebná oprávnění pro přístup k existujícímu adresáři.
Pokud adresář neexistuje, cesta obsahuje znak dvojtečky (:) který není součástí označení disku (“C:").
destinationDirectory
je řetězec s nulovou délkou, obsahuje pouze bílé znaky nebo obsahuje jeden nebo více neplatných znaků. Neplatné znaky můžete zkontrolovat pomocí metody System.IO.Path.GetInvalidPathChars.
-nebo- cesta je předcházena nebo obsahuje pouze znak dvojtečky (:).
Adresář určený cestou je soubor. -nebo- Síťový název není znám.
Save(Stream)
Ukládá snappy archiv do zadaného proudu.
public void Save(Stream output)
Parametry
output
Stream
Cílový proud.
Příklady
using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
using (var archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save(snappyFile);
}
}
Poznámky
output
musí být možné procházet.
Výjimky
output
nepodporuje procházení.
output
je null.
Save(FileInfo)
Ukládá snappy archiv do zadaného cílového souboru.
public void Save(FileInfo destination)
Parametry
destination
FileInfo
FileInfo, který bude otevřen jako cílový proud.
Příklady
using (var archive = new SnappyArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.snappy"));
}
Výjimky
Volající nemá potřebná oprávnění pro otevření destination
.
Cesta k souboru je prázdná nebo obsahuje pouze bílé znaky.
Soubor nebyl nalezen.
Cesta k souboru je pouze pro čtení nebo je to adresář.
destination
je null.
Zadaná cesta je neplatná, například je na nepřiřazeném disku.
Soubor je již otevřen.
Save(string)
Ukládá snappy archiv do zadaného cílového souboru.
public void Save(string destinationFileName)
Parametry
destinationFileName
string
Cesta archivu, který má být vytvořen. Pokud zadaný název souboru odkazuje na existující soubor, bude přepsán.
Příklady
using (var archive = new SnappyArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.snappy");
}
Výjimky
destinationFileName
je null.
Volající nemá potřebná oprávnění pro přístup.
destinationFileName
je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.
Přístup k souboru destinationFileName
je odepřen.
Zadaná destinationFileName
, název souboru nebo obojí překračuje maximální délku definovanou systémem. Například na platformách Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.
Soubor na destinationFileName
obsahuje dvojtečku (:) uprostřed řetězce.
SetSource(Stream)
Nastaví obsah, který má být komprimován v archivu.
public void SetSource(Stream source)
Parametry
source
Stream
Vstupní proud pro archiv.
Příklady
using (var archive = new SnappyArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.snappy");
}
Výjimky
Proud source
je neprocházející.
SetSource(FileInfo)
Nastaví obsah, který má být komprimován v archivu.
public void SetSource(FileInfo fileInfo)
Parametry
fileInfo
FileInfo
FileInfo, který bude otevřen jako vstupní proud.
Příklady
using (var archive = new SnappyArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.snappy");
}
Výjimky
Volající nemá potřebná oprávnění pro otevření fileInfo
.
Cesta k souboru je prázdná nebo obsahuje pouze bílé znaky.
Soubor nebyl nalezen.
Cesta k souboru je pouze pro čtení nebo je to adresář.
fileInfo
je null.
Zadaná cesta je neplatná, například je na nepřiřazeném disku.
Soubor je již otevřen.
SetSource(string)
Nastaví obsah, který má být komprimován v archivu.
public void SetSource(string sourcePath)
Parametry
sourcePath
string
Cesta k souboru, který bude otevřen jako vstupní proud.
Příklady
using (var archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.snappy");
}
Výjimky
sourcePath
je null.
Volající nemá potřebná oprávnění pro přístup.
sourcePath
je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.
Přístup k souboru sourcePath
je odepřen.
Zadaná sourcePath
, název souboru nebo obojí překračuje maximální délku definovanou systémem. Například na platformách Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.
Soubor na sourcePath
obsahuje dvojtečku (:) uprostřed řetězce.