Class ZstandardArchive
Il nome: Aspose.Zip.Zstandard Assemblea: Aspose.Zip.dll (25.5.0)
Questa classe rappresenta un file di archivio Zstandard. Usalo per compilare archivi Zstandard.
public class ZstandardArchive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
I membri ereditari
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
ZstandardArchive()
Inizializza una nuova instanza della classe Aspose.Zip.Zstandard.ZstandardArchive preparata per la compressione.
public ZstandardArchive()
Examples
Il seguente esempio mostra come comprimere un file.
using (ZstandardArchive archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}
ZstandardArchive(Strumento, ZstandardLoadOptions)
Inizializza una nuova instanza della classe Aspose.Zip.Zstandard.ZstandardArchive preparata per la decompressione.
public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)
Parameters
sourceStream
Stream
La fonte dell’archivio.
options
ZstandardLoadOptions
Le opzioni per caricare archivio con.
Examples
Aprire un archivio da un flusso ed estrarlo in un
var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
archive.Open().CopyTo(ms);
Remarks
Questo costruttore non decomprime. vedi Aspose.Zip.Zstandard.ZstandardArchive.Open metodo di decompressione.
ZstandardArchive(String, ZstandardLoadOptions)
Inizia una nuova instanza della classe Aspose.Zip.Zstandard.ZstandardArchive.
public ZstandardArchive(string path, ZstandardLoadOptions options = null)
Parameters
path
string
Il percorso verso l’archivio.
options
ZstandardLoadOptions
Le opzioni per caricare archivio con.
Examples
Aprire un archivio dal file per percorso ed estrarlo in un
var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
archive.Open().CopyTo(ms);
Remarks
Questo costruttore non decomprime. vedi Aspose.Zip.Zstandard.ZstandardArchive.Open metodo di decompressione.
Exceptions
path’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.
Il file in path’ contiene una colonna (:) nel mezzo della riga.
Methods
Dispose()
Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.
public void Dispose()
Dispose(di bool)
Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
Le risorse gestite dovrebbero essere sprecate.
Extract(Stream)
L’archivio viene estratto nel flusso fornito.
public void Extract(Stream destination)
Parameters
destination
Stream
Destinazione Stream. deve essere scritta.
Examples
using (var archive = new GzipArchive("archive.zst"))
{
archive.Extract(httpResponseStream);
}
Exceptions
destination’ does not support writing.
Extract(String)
L’archivio viene estratto nel file per via.
public FileInfo Extract(string path)
Parameters
path
string
Il percorso verso il file di destinazione. se il file esiste già, sarà sovrappeso.
Returns
Informazioni su un file estratto.
Exceptions
path’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.
Il file in path’ contiene una colonna (:) nel mezzo della riga.
ExtractToDirectory(String)
Eliminare il contenuto dell’archivio nella directory fornita.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
Il percorso verso il directory per posizionare i file estratti.
Remarks
Se il directory non esiste, sarà creato.
Exceptions
destinationDirectory’ is null.
Il percorso specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.
Il chiamante non ha il permesso richiesto per accedere al directory esistente.
Se la directory non esiste, il percorso contiene un carattere colonico (:) che non fa parte di un’etichetta drive (“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 (:).
Il directory specificato per percorso è un file. -or- Il nome della rete non è noto.
Open()
Apri l’archivio per l’estrazione e fornisce un flusso con contenuti archivi.
public Stream Open()
Returns
Il flusso che rappresenta il contenuto dell’archivio.
Examples
Elimina l’archivio e copia il contenuto estratto al file stream.
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);
}
}
Puoi usare il metodo Stream.CopyTo per .NET 4.0 e superiore: unpacked.KopiTo(estratto);
Remarks
Leggi dal flusso per ottenere il contenuto originale di un file.
Save(Strumento, ZstandardSaveOptions)
Salva archivio al flusso fornito.
public void Save(Stream outputStream, ZstandardSaveOptions settings = null)
Parameters
outputStream
Stream
Il flusso di destinazione.
settings
ZstandardSaveOptions
Impostazioni opzionali per la composizione di archivi.
Examples
Inserisci i dati compressi nel flusso di risposta http.
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}
Remarks
Deve essere scritta.
Exceptions
outputStream’ is not writable.
La fonte non è stata fornita.
Save(String, ZstandardSaveOptions)
Salva l’archivio al file di destinazione fornito.
public void Save(string destinationFileName, ZstandardSaveOptions settings = null)
Parameters
destinationFileName
string
Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.
settings
ZstandardSaveOptions
Impostazioni opzionali per la composizione di archivi.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.zst");
}
Exceptions
destinationFileName’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La destinationFileName’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file destinationFileName’ è negato.
La specifica destinationFileName’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.
Il file in destinationFileName’ contiene una colonna (:) nel mezzo della riga.
Save(FileInfo, ZstandardSaveOptions)
Salva l’archivio al file di destinazione fornito.
public void Save(FileInfo destination, ZstandardSaveOptions settings = null)
Parameters
destination
FileInfo
FileInfo, che verrà aperto come flusso di destinazione.
settings
ZstandardSaveOptions
Impostazioni opzionali per la composizione di archivi.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.zst"));
}
Exceptions
Il chiamante non ha il permesso richiesto per aprire la destinazione .
Il percorso di file è vuoto o contiene solo spazi bianchi.
Il file non è trovato.
Il percorso per il file è letto solo o è un directory.
destination’ is null.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file è già aperto.
SetSource(Stream)
Metti il contenuto per essere compreso all’interno dell’archivio.
public void SetSource(Stream source)
Parameters
source
Stream
Il flusso di input per l’archivio.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.zst");
}
SetSource(FileInfo)
Metti il contenuto per essere compreso all’interno dell’archivio.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
Il riferimento a un file da comprimere.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.zst");
}
SetSource(String)
Metti il contenuto per essere compreso all’interno dell’archivio.
public void SetSource(string path)
Parameters
path
string
Il modo in cui il file viene compreso.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}
Exceptions
path’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.
Il file in path’ contiene una colonna (:) nel mezzo della riga.