Class LzmaArchive
Namespace: Aspose.Zip.LZMA
Assembly: Aspose.Zip.dll (25.1.0)
Questa classe rappresenta un file di archivio LZMA. Usala per comporre o estrarre archivi LZMA.
public class LzmaArchive : 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
LzmaArchive(LzmaArchiveSettings)
Inizializza una nuova istanza della classe Aspose.Zip.LZMA.LzmaArchive e compone l’archivio in formato lzma.
public LzmaArchive(LzmaArchiveSettings settings = null)
Parametri
settings
LzmaArchiveSettings
Set di impostazioni particolari per l’archivio lzma.
LzmaArchive(Stream)
Inizializza una nuova istanza della classe Aspose.Zip.LZMA.LzmaArchive preparata per la decompressione.
public LzmaArchive(Stream source)
Parametri
source
Stream
La sorgente dell’archivio.
Osservazioni
Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) per decomprimere.
Eccezioni
source
non è cercabile.
source
è nullo.
LzmaArchive(string)
Inizializza una nuova istanza della classe Aspose.Zip.LZMA.LzmaArchive preparata per la decompressione.
public LzmaArchive(string path)
Parametri
path
string
Percorso alla sorgente dell’archivio.
Esempi
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}
Osservazioni
Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) per decomprimere.
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
specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle 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.
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 lzma in uno stream.
public void Extract(Stream destination)
Parametri
destination
Stream
Stream per memorizzare i dati decompressi.
Esempi
using (FileStream sourceLzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}
}
Eccezioni
Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.
L’archivio è corrotto.
Lo stream di destinazione è nullo.
Lo stream di destinazione non supporta la scrittura.
Extract(FileInfo)
Estrae l’archivio lzma in un file.
public void Extract(FileInfo fileInfo)
Parametri
fileInfo
FileInfo
FileInfo per memorizzare i dati decompressi.
Esempi
using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
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, se si trova su un’unità non mappata.
Il file è già aperto.
L’archivio è corrotto.
Extract(string)
Estrae l’archivio lzma in un file tramite percorso.
public void Extract(string path)
Parametri
path
string
Percorso del file che memorizzerà i dati decompressi.
Esempi
using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
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
specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle 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.
L’archivio è corrotto.
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, nelle 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 verificare i caratteri non validi utilizzando il metodo System.IO.Path.GetInvalidPathChars.
-o- il percorso è preceduto o contiene solo un carattere due punti (:).
La directory specificata dal percorso è un file. -o- Il nome della rete non è conosciuto.
L’archivio è corrotto.
Save(Stream)
Salva l’archivio lzma nello stream fornito.
public void Save(Stream output)
Parametri
output
Stream
Stream di destinazione.
Esempi
using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save(lzmaFile);
}
}
Osservazioni
output
deve essere cercabile.
Eccezioni
output
non supporta la ricerca.
output
è nullo.
Save(FileInfo)
Salva l’archivio lzma 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 LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lzma"));
}
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.
Save(string)
Salva l’archivio lzma 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 LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lzma");
}
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
specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle 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 LzmaArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lzma");
}
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 LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lzma");
}
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, se 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 LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lzma");
}
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
specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle 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.