Class SnappyArchive

Class SnappyArchive

Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)

Questa classe rappresenta un file di archivio snappy. Usala per comporre o estrarre archivi snappy.

public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry

Ereditarietà

objectSnappyArchive

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

SnappyArchive()

Inizializza una nuova istanza della classe Aspose.Zip.Snappy.SnappyArchive preparata per la compressione.

public SnappyArchive()

Esempi

Il seguente esempio mostra come comprimere un file.

using (SnappyArchive archive = new SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snapy");
}

SnappyArchive(Stream)

Inizializza una nuova istanza della classe Aspose.Zip.Snappy.SnappyArchive preparata per la decompressione.

public SnappyArchive(Stream source)

Parametri

source Stream

La sorgente dell’archivio.

Osservazioni

Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) per la decompressione.

Eccezioni

ArgumentException

source non è cercabile.

ArgumentNullException

source è nullo.

SnappyArchive(string)

Inizializza una nuova istanza della classe Aspose.Zip.Snappy.SnappyArchive preparata per la decompressione.

public SnappyArchive(string path)

Parametri

path string

Percorso della sorgente dell’archivio.

Esempi

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new SnappyArchive(sourceSnappyFile))
    {
         archive.Extract(extractedFile);
    }
   }

Osservazioni

Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) per la decompressione.

Eccezioni

ArgumentNullException

path è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il path è vuoto, contiene solo spazi bianchi, o contiene caratteri non validi.

UnauthorizedAccessException

Accesso al file path negato.

PathTooLongException

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.

NotSupportedException

Il file a path contiene un due punti (:) nel mezzo della stringa.

FileNotFoundException

Il file non è stato trovato.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova su un’unità non mappata.

IOException

Il file è già aperto.

Metodi

Dispose()

Esegue operazioni definite dall’applicazione associate alla liberazione, al rilascio o al ripristino delle risorse non gestite.

public void Dispose()

Dispose(bool)

Esegue operazioni 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 snappy in uno stream.

public void Extract(Stream destination)

Parametri

destination Stream

Stream per memorizzare i dati decompressi.

Esempi

using (FileStream sourceSnappyFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
       using (var archive = new SnappyArchive(sourceSnappyFile))
       {
           archive.Extract(extractedFile);
       }
   }
}

Eccezioni

InvalidOperationException

Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.

InvalidDataException

Errore nei dati nell’intestazione o nel checksum.

ArgumentNullException

Lo stream di destinazione è nullo.

ArgumentException

Lo stream di destinazione non supporta la scrittura.

Extract(FileInfo)

Estrae l’archivio snappy in un file.

public void Extract(FileInfo fileInfo)

Parametri

fileInfo FileInfo

FileInfo per memorizzare i dati decompressi.

Esempi

using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new SnappyArchive(snappyFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Eccezioni

InvalidOperationException

Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.

SecurityException

Il chiamante non ha il permesso richiesto per aprire il fileInfo.

ArgumentException

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

FileNotFoundException

Il file non è stato trovato.

UnauthorizedAccessException

Il percorso del file è di sola lettura o è una directory.

ArgumentNullException

fileInfo è nullo.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova su un’unità non mappata.

IOException

Il file è già aperto.

Extract(string)

Estrae l’archivio snappy in un file tramite percorso.

public FileInfo Extract(string path)

Parametri

path string

Percorso del file che memorizzerà i dati decompressi.

Restituisce

FileInfo

Istanza di System.IO.FileInfo contenente i dati estratti.

Esempi

using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new SnappyArchive(snappyFile))
    {
        archive.Extract("extracted.bin");
    }
}

Eccezioni

InvalidOperationException

Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.

ArgumentNullException

path è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il path è vuoto, contiene solo spazi bianchi, o contiene caratteri non validi.

UnauthorizedAccessException

Accesso al file path negato.

PathTooLongException

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.

NotSupportedException

Il file a path contiene un 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

ArgumentNullException

destinationDirectory è nullo.

PathTooLongException

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.

SecurityException

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

NotSupportedException

Se la directory non esiste, il percorso contiene un carattere due punti (:) che non fa parte di un’etichetta di unità (“C:").

ArgumentException

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 è prefissato con, o contiene, solo un carattere due punti (:).

IOException

La directory specificata dal percorso è un file. -o- Il nome della rete non è noto.

Save(Stream)

Salva l’archivio snappy nello stream fornito.

public void Save(Stream output)

Parametri

output Stream

Stream di destinazione.

Esempi

using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
    using (var archive = new SnappyArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(snappyFile);
     }
}

Osservazioni

output deve essere cercabile.

Eccezioni

ArgumentException

output non supporta la ricerca.

ArgumentNullException

output è nullo.

Save(FileInfo)

Salva l’archivio snappy nel file di destinazione fornito.

public void Save(FileInfo destination)

Parametri

destination FileInfo

FileInfo che verrà aperto come stream di destinazione.

Esempi

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

Eccezioni

SecurityException

Il chiamante non ha il permesso richiesto per aprire il destination.

ArgumentException

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

FileNotFoundException

Il file non è stato trovato.

UnauthorizedAccessException

Il percorso del file è di sola lettura o è una directory.

ArgumentNullException

destination è nullo.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova su un’unità non mappata.

IOException

Il file è già aperto.

Save(string)

Salva l’archivio snappy nel file di destinazione fornito.

public void Save(string destinationFileName)

Parametri

destinationFileName string

Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.

Esempi

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

Eccezioni

ArgumentNullException

destinationFileName è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il destinationFileName è vuoto, contiene solo spazi bianchi, o contiene caratteri non validi.

UnauthorizedAccessException

Accesso al file destinationFileName negato.

PathTooLongException

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.

NotSupportedException

Il file a destinationFileName contiene un due punti (:) nel mezzo della stringa.

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 SnappyArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.snappy");
}

Eccezioni

ArgumentException

Lo stream source non è cercabile.

SetSource(FileInfo)

Imposta il contenuto da comprimere all’interno dell’archivio.

public void SetSource(FileInfo fileInfo)

Parametri

fileInfo FileInfo

FileInfo che verrà aperto come stream di input.

Esempi

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

Eccezioni

SecurityException

Il chiamante non ha il permesso richiesto per aprire il fileInfo.

ArgumentException

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

FileNotFoundException

Il file non è stato trovato.

UnauthorizedAccessException

Il percorso del file è di sola lettura o è una directory.

ArgumentNullException

fileInfo è nullo.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova su un’unità non mappata.

IOException

Il file è già aperto.

SetSource(string)

Imposta il contenuto da comprimere all’interno dell’archivio.

public void SetSource(string sourcePath)

Parametri

sourcePath string

Percorso del file che verrà aperto come stream di input.

Esempi

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

Eccezioni

ArgumentNullException

sourcePath è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il sourcePath è vuoto, contiene solo spazi bianchi, o contiene caratteri non validi.

UnauthorizedAccessException

Accesso al file sourcePath negato.

PathTooLongException

Il sourcePath, 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.

NotSupportedException

Il file a sourcePath contiene un due punti (:) nel mezzo della stringa.

 Italiano