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à
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
source
non è cercabile.
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
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 un due punti (:) nel mezzo della stringa.
Il file non è stato trovato.
Il percorso specificato non è valido, ad esempio si trova su un’unità non mappata.
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
Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.
Errore nei dati nell’intestazione o nel checksum.
Lo stream di destinazione è nullo.
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
Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.
Il chiamante non ha il permesso richiesto per aprire il fileInfo
.
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.
fileInfo
è nullo.
Il percorso specificato non è valido, ad esempio si trova su un’unità non mappata.
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
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
Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.
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 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
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 è prefissato con, o contiene, solo un carattere due punti (:).
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
output
non supporta la ricerca.
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
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 si trova su un’unità non mappata.
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
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 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
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
Il chiamante non ha il permesso richiesto per aprire il fileInfo
.
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.
fileInfo
è nullo.
Il percorso specificato non è valido, ad esempio si trova su un’unità non mappata.
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
sourcePath
è nullo.
Il chiamante non ha il permesso richiesto per accedere.
Il sourcePath
è vuoto, contiene solo spazi bianchi, o contiene caratteri non validi.
Accesso al file sourcePath
negato.
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.
Il file a sourcePath
contiene un due punti (:) nel mezzo della stringa.