Class ZstandardArchive

Class ZstandardArchive

Název místa: Aspose.Zip.Zstandard Sbírka: Aspose.Zip.dll (25.5.0)

Tato třída představuje archivní soubor Zstandard. Použijte ho k sestavování archivů Zstandard.

public class ZstandardArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZstandardArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

Dědiční členové

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

Constructors

ZstandardArchive()

Začíná nový příklad třídy Aspose.Zip.Zstandard.ZstandardArchive připravené pro komprese.

public ZstandardArchive()

Examples

Následující příklad ukazuje, jak komprimovat soubor.

using (ZstandardArchive archive = new ZstandardArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.zst");
}

ZstandardArchive(Stream, ZstandardLoadOptions)

Začíná nový příklad třídy Aspose.Zip.Zstandard.ZstandardArchive připravené k dekompresován.

public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)

Parameters

sourceStream Stream

Zdroj z archivu.

options ZstandardLoadOptions

Možnosti načtení archiv.

Examples

Otevřete archiv z toku a extrahujte ho do

var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
  archive.Open().CopyTo(ms);

Remarks

Tento konstruktor není dekompresní. viz Aspose.Zip.Zstandard.ZstandardArchive.Otevřená metoda dekompresn.

ZstandardArchive(Třída, ZstandardLoadOptions)

Začíná nový příklad třídy Aspose.Zip.Zstandard.ZstandardArchive.

public ZstandardArchive(string path, ZstandardLoadOptions options = null)

Parameters

path string

Cesta do archivního souboru.

options ZstandardLoadOptions

Možnosti načtení archiv.

Examples

Otevřete archiv z souboru podle trasy a extrahujte ho do

var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
  archive.Open().CopyTo(ms);

Remarks

Tento konstruktor není dekompresní. viz Aspose.Zip.Zstandard.ZstandardArchive.Otevřená metoda dekompresn.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path’ obsahuje kolonu (:) uprostřed řádku.

Methods

Dispose()

Provádí aplikativně definované úkoly spojené s uvolňováním, uvolňováním nebo resetováním neupravených zdroj.

public void Dispose()

Dispose(Bolíček)

Provádí aplikativně definované úkoly spojené s uvolňováním, uvolňováním nebo resetováním neupravených zdroj.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Je nutné zlikvidovat spravované zdroje.

Extract(Stream)

Vytahuje archiv do poskytnutého toku.

public void Extract(Stream destination)

Parameters

destination Stream

Destinace stream. musí být psateln.

Examples

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

Extract(Stringová)

Vytahuje archiv do souboru cestou.

public FileInfo Extract(string path)

Parameters

path string

Cesta k cílovému souboru.Pokud soubor již existuje, bude přepsan.

Returns

FileInfo

Informace o vydaném souboru.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path’ obsahuje kolonu (:) uprostřed řádku.

ExtractToDirectory(Stringová)

Obsah archivu extrahuje do poskytnutého adresáře.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Cesta do adresáře umístit extrahované soubory do.

Remarks

Pokud adresář neexistuje, bude vytvořen.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Zadaná trasa, název souboru nebo obojí přesahuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být trasa menší než 248 znaků a název souboru musí být menší než 260 znak.

SecurityException

Návštěvník nemá požadované povolení k přístupu k stávajícímu adresáři.

NotSupportedException

Pokud adresář neexistuje, trasa obsahuje znak kolonu (:) který není součástí označení disku (“C:”).

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

dek určený cestou je soubor. -or- Název sítě není znám.

Open()

Otevře archiv pro extrahování a poskytuje tok s obsahem archivu.

public Stream Open()

Returns

Stream

Průtok, který představuje obsah archivu.

Examples

Extrahuje archiv a kopíruje extrahovaný obsah do streamování soubor.

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Můžete použít metodu Stream.CopyTo pro .NET 4.0 a vyšší: unpacked.Kopíto(vyvedeno);

Remarks

Přečtěte si z toku, abyste získali původní obsah souboru.

Save(Stream, ZstandardSaveOptions)

Ušetří archiv na poskytnutém toku.

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

Parameters

outputStream Stream

Destinace v toku.

settings ZstandardSaveOptions

Volitelné nastavení pro archivní složen.

Examples

Napište komprimované údaje na HTTP reakční proud.

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

Remarks

Musí být psatelná.

Exceptions

ArgumentException

outputStream’ is not writable.

InvalidOperationException

Zdroj nebyl dodán.

Save(String, ZstandardSaveOptions)

Ušetří archiv na předloženém cílovém souboru.

public void Save(string destinationFileName, ZstandardSaveOptions settings = null)

Parameters

destinationFileName string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

settings ZstandardSaveOptions

Volitelné nastavení pro archivní složen.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu.

ArgumentException

code class=“paramref”>destinationFileName’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru destinationFileName’ je odmítnut.

PathTooLongException

Uvedený destinationFileName’, název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows musí být trasy menší než 248 znaků a název souboru musí být menší než 260 znak.

NotSupportedException

Soubor na destinationFileName’ obsahuje kolonku (:) uprostřed řádku.

Save(FileInfo a ZstandardSaveOptions)

Ušetří archiv na předloženém cílovém souboru.

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

Parameters

destination FileInfo

FileInfo, který se otevře jako cílový proud.

settings ZstandardSaveOptions

Volitelné nastavení pro archivní složen.

Examples

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

Exceptions

SecurityException

Volající nemá požadované povolení k otevření destinace <code class=“paramref'.

ArgumentException

Stránka je prázdná nebo obsahuje pouze bílé prostory.

FileNotFoundException

Soubor nebyl nalezen.

UnauthorizedAccessException

Cesta k souboru je čtená pouze nebo je adres.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

IOException

Soubor je již otevřen.

SetSource(Stream)

Vložte obsah, který bude komprimován v archivu.

public void SetSource(Stream source)

Parameters

source Stream

Vstupní proud pro archiv.

Examples

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

SetSource(FileInfo)

Vložte obsah, který bude komprimován v archivu.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

odkaz na soubor, který má být komprimován.

Examples

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

SetSource(Stringová)

Vložte obsah, který bude komprimován v archivu.

public void SetSource(string path)

Parameters

path string

Způsob, jak dosáhnout komprese.

Examples

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path” je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path’ obsahuje kolonu (:) uprostřed řádku.

 Čeština