Class ZstandardArchive

Class ZstandardArchive

Nom dels espais: Aspose.Zip.Zstandard Assemblea: Aspose.Zip.dll (25.5.0)

Aquesta classe representa un arxiu estàndard. Utilitzeu-lo per compondre arxius estàndard.

public class ZstandardArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZstandardArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

Membres heretats

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

Constructors

ZstandardArchive()

Inicia una nova instància de la classe Aspose.Zip.Zstandard.ZstandardArxiu preparat per a la compressi.

public ZstandardArchive()

Examples

L’exemple següent mostra com comprimir un fitxer.

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

ZstandardArchive(Projecció, ZstandardLoadOptions)

Inicia una nova instància de la classe Aspose.Zip.Zstandard.ZstandardArxiu preparat per a la decompressi.

public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)

Parameters

sourceStream Stream

La font de l’arxiu.

options ZstandardLoadOptions

Les opcions per carregar arxius amb.

Examples

Obre un arxiu d’un corrent i extreure’l a un

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

Remarks

Aquest constructor no descomprimeix. Veure Aspose.Zip.Zstandard.ZstandardArchive.Open mètode per descomprimir.

ZstandardArchive(Llista d’opcions, ZstandardLoadOptions)

Inicia una nova instància de la classe Aspose.Zip.Zstandard.ZstandardArxiu.

public ZstandardArchive(string path, ZstandardLoadOptions options = null)

Parameters

path string

El camí cap a l’arxiu.

options ZstandardLoadOptions

Les opcions per carregar arxius amb.

Examples

Obre un arxiu del fitxer per ruta i extreure-lo a un

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

Remarks

Aquest constructor no descomprimeix. Veure Aspose.Zip.Zstandard.ZstandardArchive.Open mètode per descomprimir.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

Methods

Dispose()

Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.

public void Dispose()

Dispose(La botiga)

Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

S’han de disposar de recursos gestionats.

Extract(Stream)

L’arxiu s’extreu al flux proporcionat.

public void Extract(Stream destination)

Parameters

destination Stream

La destinació ha de ser escrita.

Examples

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

Exceptions

ArgumentException

destination’ does not support writing.

Extract(Tàrrega)

Extreure l’arxiu al fitxer per cam.

public FileInfo Extract(string path)

Parameters

path string

El camí a l’arxiu de destinació. Si el fitxer ja existeix, serà sobreescrit.

Returns

FileInfo

Informació d’un arxiu extraït.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

ExtractToDirectory(Tàrrega)

Extreu el contingut de l’arxiu a la direcció proporcionada.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

El camí a la direcció per col·locar els arxius extraïts.

Remarks

Si la direcció no existeix, es crear.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters i els noms de fitxers han de ser menys de 260 caràcters.

SecurityException

El sol·licitant no té l’autorització necessària per accedir a la direcció existent.

NotSupportedException

Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“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

El directori especificat per ruta és un arxiu. -o- El nom de la xarxa no és conegut.

Open()

Obre l’arxiu per a l’extracció i proporciona un flux amb contingut d’arxiu.

public Stream Open()

Returns

Stream

El corrent que representa el contingut de l’arxiu.

Examples

Extrata l’arxiu i copia el contingut extraït al flux de fitxers.

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);
    }            
}

Podeu utilitzar el mètode Stream.CopyTo per a .NET 4.0 i més alt: ‘unpacked.KopiTo(extraït);’

Remarks

Llegeix des del flux per obtenir el contingut original d’un fitxer. Veure secció exemples.

Save(Projecció, ZstandardSaveOptions)

Salva l’arxiu al corrent proporcionat.

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

Parameters

outputStream Stream

El flux de destinaci.

settings ZstandardSaveOptions

Configuració opcional per a la composició d’arxius.

Examples

Escriu les dades comprimides al flux de resposta HTTP.

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

Remarks

Ha de ser escriïble.

Exceptions

ArgumentException

outputStream’ is not writable.

InvalidOperationException

La font no s’ha proporcionat.

Save(Llista d’opcions, ZstandardSaveOptions)

Salva l’arxiu al fitxer de destinació proporcionat.

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

Parameters

destinationFileName string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

settings ZstandardSaveOptions

Configuració opcional per a la composició d’arxius.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

El destinationFileName’ és buit, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer destinationFileName’ és negat.

PathTooLongException

El nom de fitxer especificat destinationFileName, o ambdós superen la longitud màxima definida pel sistema. Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer a destinationFileName’ conté una columna (:) al mig de la cadena.

Save(FileInfo i ZstandardSaveOptions)

Salva l’arxiu al fitxer de destinació proporcionat.

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

Parameters

destination FileInfo

FileInfo, que s’obrirà com a flux de destinació.

settings ZstandardSaveOptions

Configuració opcional per a la composició d’arxius.

Examples

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

Exceptions

SecurityException

El convocador no té el permís requerit per obrir la destinació <code class=“paramref'.

ArgumentException

La ruta de fitxer és buida o només conté espais blancs.

FileNotFoundException

El fitxer no es troba.

UnauthorizedAccessException

El camí a l’arxiu és només llegit o és un directori.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

IOException

El fitxer ja està obert.

SetSource(Stream)

Establir el contingut per a ser comprès dins de l’arxiu.

public void SetSource(Stream source)

Parameters

source Stream

El flux d’entrada per a l’arxiu.

Examples

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

SetSource(FileInfo)

Establir el contingut per a ser comprès dins de l’arxiu.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

La referència a un arxiu a ser comprès.

Examples

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

SetSource(Tàrrega)

Establir el contingut per a ser comprès dins de l’arxiu.

public void SetSource(string path)

Parameters

path string

El camí per a arxiu per a ser comprès.

Examples

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path” es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

 Català