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
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
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
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
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
Informació d’un arxiu extraït.
Exceptions
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
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
destinationDirectory’ is null.
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.
El sol·licitant no té l’autorització necessària per accedir a la direcció existent.
Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“C:”).
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 (:).
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
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
outputStream’ is not writable.
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
destinationFileName’ is null.
El client no té el permís d’accés requerit.
El destinationFileName’ és buit, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer destinationFileName’ és negat.
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.
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
El convocador no té el permís requerit per obrir la destinació <code class=“paramref'.
La ruta de fitxer és buida o només conté espais blancs.
El fitxer no es troba.
El camí a l’arxiu és només llegit o és un directori.
destination’ is null.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
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
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path” es nega.
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.
El fitxer a path’ conté una columna (:) al mig de la cadena.