Class ZstandardArchive

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

object ZstandardArchive

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

ArgumentNullException

path’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

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.

NotSupportedException

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

ArgumentException

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

FileInfo

Informazioni su un file estratto.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

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.

NotSupportedException

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

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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.

SecurityException

Il chiamante non ha il permesso richiesto per accedere al directory esistente.

NotSupportedException

Se la directory non esiste, il percorso contiene un carattere colonico (:) che non fa parte di un’etichetta drive (“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

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

Stream

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

ArgumentException

outputStream’ is not writable.

InvalidOperationException

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

ArgumentNullException

destinationFileName’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La destinationFileName’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file destinationFileName’ è negato.

PathTooLongException

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.

NotSupportedException

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

SecurityException

Il chiamante non ha il permesso richiesto per aprire la destinazione .

ArgumentException

Il percorso di file è vuoto o contiene solo spazi bianchi.

FileNotFoundException

Il file non è trovato.

UnauthorizedAccessException

Il percorso per il file è letto solo o è un directory.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

IOException

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

ArgumentNullException

path’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

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.

NotSupportedException

Il file in path’ contiene una colonna (:) nel mezzo della riga.

 Italiano