Class ZstandardArchive
Namespace: Aspose.Zip.Zstandard
Assembly: Aspose.Zip.dll (25.1.0)
Questa classe rappresenta un file di archivio Zstandard. Usala per comporre archivi Zstandard.
public class ZstandardArchive : IArchive, IDisposable, IArchiveFileEntryEreditarietà
Implementa
IArchive, IDisposable, IArchiveFileEntry
Membri Ereditati
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Costruttori
ZstandardArchive()
Inizializza una nuova istanza della classe Aspose.Zip.Zstandard.ZstandardArchive preparata per la compressione.
public ZstandardArchive()Esempi
Il seguente esempio mostra come comprimere un file.
using (ZstandardArchive archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}ZstandardArchive(Stream, ZstandardLoadOptions)
Inizializza una nuova istanza della classe Aspose.Zip.Zstandard.ZstandardArchive preparata per la decompressione.
public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)Parametri
sourceStream Stream
La sorgente dell’archivio.
options ZstandardLoadOptions
Le opzioni per caricare l’archivio.
Esempi
Apri un archivio da uno stream ed estrailo in un MemoryStream
var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
archive.Open().CopyTo(ms);Osservazioni
Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Zstandard.ZstandardArchive.Open per la decompressione.
ZstandardArchive(string, ZstandardLoadOptions)
Inizializza una nuova istanza della classe Aspose.Zip.Zstandard.ZstandardArchive.
public ZstandardArchive(string path, ZstandardLoadOptions options = null)Parametri
path string
Il percorso del file di archivio.
options ZstandardLoadOptions
Le opzioni per caricare l’archivio.
Esempi
Apri un archivio da un file tramite il percorso ed estrailo in un MemoryStream
var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
archive.Open().CopyTo(ms);Osservazioni
Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Zstandard.ZstandardArchive.Open per la decompressione.
Eccezioni
path è nullo.
Il chiamante non ha il permesso richiesto per accedere.
Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.
Accesso al file path negato.
Il path, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.
Il file a path contiene due punti (:) nel mezzo della stringa.
Metodi
Dispose()
Esegue attività definite dall’applicazione associate alla liberazione, al rilascio o al ripristino delle risorse non gestite.
public void Dispose()Dispose(bool)
Esegue attività definite dall’applicazione associate alla liberazione, al rilascio o al ripristino delle risorse non gestite.
protected virtual void Dispose(bool disposing)Parametri
disposing bool
Se le risorse gestite devono essere liberate.
Extract(Stream)
Estrae l’archivio nello stream fornito.
public void Extract(Stream destination)Parametri
destination Stream
Stream di destinazione. Deve essere scrivibile.
Esempi
using (var archive = new GzipArchive("archive.zst"))
{
archive.Extract(httpResponseStream);
}Eccezioni
destination non supporta la scrittura.
Extract(string)
Estrae l’archivio nel file tramite il percorso.
public FileInfo Extract(string path)Parametri
path string
Il percorso del file di destinazione. Se il file esiste già, verrà sovrascritto.
Restituisce
Info del file estratto.
Eccezioni
path è nullo.
Il chiamante non ha il permesso richiesto per accedere.
Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.
Accesso al file path negato.
Il path, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.
Il file a path contiene due punti (:) nel mezzo della stringa.
ExtractToDirectory(string)
Estrae il contenuto dell’archivio nella directory fornita.
public void ExtractToDirectory(string destinationDirectory)Parametri
destinationDirectory string
Il percorso della directory in cui posizionare i file estratti.
Osservazioni
Se la directory non esiste, verrà creata.
Eccezioni
destinationDirectory è nullo.
Il percorso specificato, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.
Il chiamante non ha il permesso richiesto per accedere alla directory esistente.
Se la directory non esiste, il percorso contiene un carattere due punti (:) che non fa parte di un’etichetta di unità (“C:").
destinationDirectory è una stringa di lunghezza zero, contiene solo spazi bianchi o contiene uno o più caratteri non validi. Puoi interrogare i caratteri non validi utilizzando il metodo System.IO.Path.GetInvalidPathChars.
-o- il percorso è preceduto da, o contiene, solo un carattere due punti (:).
La directory specificata dal percorso è un file. -o- Il nome di rete non è conosciuto.
Open()
Apre l’archivio per l’estrazione e fornisce uno stream con il contenuto dell’archivio.
public Stream Open()Restituisce
Lo stream che rappresenta il contenuto dell’archivio.
Esempi
Estrae l'archivio e copia il contenuto estratto nello stream di file.
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 superiori: `unpacked.CopyTo(extracted);`
Osservazioni
Leggi dallo stream per ottenere il contenuto originale del file. Vedi la sezione esempi.
Save(Stream, ZstandardSaveOptions)
Salva l’archivio nello stream fornito.
public void Save(Stream outputStream, ZstandardSaveOptions settings = null)Parametri
outputStream Stream
Stream di destinazione.
settings ZstandardSaveOptions
Impostazioni opzionali per la composizione dell’archivio.
Esempi
Scrive i dati compressi nello stream di risposta http.
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Osservazioni
outputStream deve essere scrivibile.
Eccezioni
outputStream non è scrivibile.
La sorgente non è stata fornita.
Save(string, ZstandardSaveOptions)
Salva l’archivio nel file di destinazione fornito.
public void Save(string destinationFileName, ZstandardSaveOptions settings = null)Parametri
destinationFileName string
Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.
settings ZstandardSaveOptions
Impostazioni opzionali per la composizione dell’archivio.
Esempi
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.zst");
}Eccezioni
destinationFileName è nullo.
Il chiamante non ha il permesso richiesto per accedere.
Il destinationFileName è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.
Accesso al file destinationFileName negato.
Il destinationFileName, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.
Il file a destinationFileName contiene due punti (:) nel mezzo della stringa.
Save(FileInfo, ZstandardSaveOptions)
Salva l’archivio nel file di destinazione fornito.
public void Save(FileInfo destination, ZstandardSaveOptions settings = null)Parametri
destination FileInfo
FileInfo che verrà aperto come stream di destinazione.
settings ZstandardSaveOptions
Impostazioni opzionali per la composizione dell’archivio.
Esempi
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.zst"));
}Eccezioni
Il chiamante non ha il permesso richiesto per aprire il destination.
Il percorso del file è vuoto o contiene solo spazi bianchi.
Il file non è stato trovato.
Il percorso del file è di sola lettura o è una directory.
destination è nullo.
Il percorso specificato non è valido, ad esempio se si trova su un’unità non mappata.
Il file è già aperto.
SetSource(Stream)
Imposta il contenuto da comprimere all’interno dell’archivio.
public void SetSource(Stream source)Parametri
source Stream
Lo stream di input per l’archivio.
Esempi
using (var archive = new ZstandardArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.zst");
}SetSource(FileInfo)
Imposta il contenuto da comprimere all’interno dell’archivio.
public void SetSource(FileInfo fileInfo)Parametri
fileInfo FileInfo
Il riferimento a un file da comprimere.
Esempi
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.zst");
}SetSource(string)
Imposta il contenuto da comprimere all’interno dell’archivio.
public void SetSource(string path)Parametri
path string
Percorso del file da comprimere.
Esempi
using (var archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}Eccezioni
path è nullo.
Il chiamante non ha il permesso richiesto per accedere.
Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.
Accesso al file path negato.
Il path, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.
Il file a path contiene due punti (:) nel mezzo della stringa.
