Class SnappyArchive

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

objectSnappyArchive

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

ArgumentException

source není možné procházet.

ArgumentNullException

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

ArgumentNullException

path je null.

SecurityException

Volající nemá potřebná oprávnění pro přístup.

ArgumentException

path je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path je odepřen.

PathTooLongException

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ů.

NotSupportedException

Soubor na path obsahuje dvojtečku (:) uprostřed řetězce.

FileNotFoundException

Soubor nebyl nalezen.

DirectoryNotFoundException

Zadaná cesta je neplatná, například je na nepřiřazeném disku.

IOException

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

InvalidOperationException

Hlavičky archivu a informace o službách nebyly přečteny.

InvalidDataException

Chyba v datech v hlavičce nebo kontrolním součtu.

ArgumentNullException

Cílový proud je null.

ArgumentException

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

InvalidOperationException

Hlavičky archivu a informace o službách nebyly přečteny.

SecurityException

Volající nemá potřebná oprávnění pro otevření fileInfo.

ArgumentException

Cesta k souboru je prázdná nebo obsahuje pouze bílé znaky.

FileNotFoundException

Soubor nebyl nalezen.

UnauthorizedAccessException

Cesta k souboru je pouze pro čtení nebo je to adresář.

ArgumentNullException

fileInfo je null.

DirectoryNotFoundException

Zadaná cesta je neplatná, například je na nepřiřazeném disku.

IOException

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í

FileInfo

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

InvalidOperationException

Hlavičky archivu a informace o službách nebyly přečteny.

ArgumentNullException

path je null.

SecurityException

Volající nemá potřebná oprávnění pro přístup.

ArgumentException

path je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path je odepřen.

PathTooLongException

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ů.

NotSupportedException

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

ArgumentNullException

destinationDirectory je null.

PathTooLongException

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ů.

SecurityException

Volající nemá potřebná oprávnění pro přístup k existujícímu adresáři.

NotSupportedException

Pokud adresář neexistuje, cesta obsahuje znak dvojtečky (:) který není součástí označení disku (“C:").

ArgumentException

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

IOException

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

ArgumentException

output nepodporuje procházení.

ArgumentNullException

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

SecurityException

Volající nemá potřebná oprávnění pro otevření destination.

ArgumentException

Cesta k souboru je prázdná nebo obsahuje pouze bílé znaky.

FileNotFoundException

Soubor nebyl nalezen.

UnauthorizedAccessException

Cesta k souboru je pouze pro čtení nebo je to adresář.

ArgumentNullException

destination je null.

DirectoryNotFoundException

Zadaná cesta je neplatná, například je na nepřiřazeném disku.

IOException

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

ArgumentNullException

destinationFileName je null.

SecurityException

Volající nemá potřebná oprávnění pro přístup.

ArgumentException

destinationFileName je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru destinationFileName je odepřen.

PathTooLongException

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ů.

NotSupportedException

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

ArgumentException

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

SecurityException

Volající nemá potřebná oprávnění pro otevření fileInfo.

ArgumentException

Cesta k souboru je prázdná nebo obsahuje pouze bílé znaky.

FileNotFoundException

Soubor nebyl nalezen.

UnauthorizedAccessException

Cesta k souboru je pouze pro čtení nebo je to adresář.

ArgumentNullException

fileInfo je null.

DirectoryNotFoundException

Zadaná cesta je neplatná, například je na nepřiřazeném disku.

IOException

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

ArgumentNullException

sourcePath je null.

SecurityException

Volající nemá potřebná oprávnění pro přístup.

ArgumentException

sourcePath je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru sourcePath je odepřen.

PathTooLongException

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ů.

NotSupportedException

Soubor na sourcePath obsahuje dvojtečku (:) uprostřed řetězce.

 Čeština