Class LzipArchive
Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)
Questa classe rappresenta un file di archivio Lzip. Usala per comporre o estrarre archivi Lzip.
public class LzipArchive : 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
LzipArchive(LzipArchiveSettings)
Inizializza una nuova istanza di Aspose.Zip.Lzip.LzipArchive.
public LzipArchive(LzipArchiveSettings settings = null)
Parametri
settings
LzipArchiveSettings
Impostazione di un particolare archivio lzip con definizione della dimensione del dizionario.
LzipArchive(Stream)
Inizializza una nuova istanza della classe Aspose.Zip.Lzip.LzipArchive preparata per la decompressione.
public LzipArchive(Stream sourceStream)
Parametri
sourceStream
Stream
La sorgente dell’archivio.
Osservazioni
Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) per la decompressione.
Eccezioni
sourceStream
non è cercabile.
sourceStream
è nullo.
Le intestazioni non corrispondono al tipo di archivio lzip.
LzipArchive(string)
Inizializza una nuova istanza della classe Aspose.Zip.Lzip.LzipArchive preparata per la decompressione.
public LzipArchive(string path)
Parametri
path
string
Percorso alla sorgente dell’archivio.
Esempi
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzipArchive(sourceLzipFile))
{
archive.Extract(extractedFile);
}
}
Osservazioni
Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Lzip.LzipArchive.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 in path
contiene un due punti (:) nel mezzo della stringa.
Il file non è stato trovato.
Il percorso specificato non è valido, ad esempio se si trova su un’unità non mappata.
Il file è già aperto.
Le intestazioni non corrispondono al tipo di archivio lzip.
Proprietà
Settings
Ottiene l’impostazione di un particolare archivio lzip.
public LzipArchiveSettings Settings { get; }
Valore della Proprietà
Metodi
Dispose()
Esegue attività definite dall’applicazione associate alla liberazione, rilascio o reimpostazione delle risorse non gestite.
public void Dispose()
Dispose(bool)
Esegue attività definite dall’applicazione associate alla liberazione, rilascio o reimpostazione 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 lzip in uno stream.
public void Extract(Stream destination)
Parametri
destination
Stream
Stream per memorizzare i dati decompressi.
Esempi
using (FileStream sourceLzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzipArchive(sourceLzipFile))
{
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 lzip in un file.
public void Extract(FileInfo fileInfo)
Parametri
fileInfo
FileInfo
FileInfo per memorizzare i dati decompressi.
Esempi
using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzipArchive(lzipFile))
{
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.
Extract(string)
Estrae l’archivio lzip in un file tramite percorso.
public void Extract(string path)
Parametri
path
string
Percorso al file che memorizzerà i dati decompressi.
Esempi
using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzipArchive(xzFile))
{
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 in 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 è conosciuto.
Save(Stream)
Salva l’archivio lzip nello stream fornito.
public void Save(Stream outputStream)
Parametri
outputStream
Stream
Stream di destinazione.
Esempi
using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save(lzFile);
}
}
Osservazioni
outputStream
deve essere cercabile.
Eccezioni
outputStream
non supporta la ricerca.
outputStream
è nullo.
Save(string)
Salva l’archivio lzip 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 LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lz");
}
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 in destinationFileName
contiene un due punti (:) nel mezzo della stringa.
Save(FileInfo)
Salva l’archivio lzip 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 LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lz"));
}
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 LzipArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz");
}
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 LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lz");
}
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 path)
Parametri
path
string
Percorso al file da comprimere.
Esempi
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz");
}
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 in path
contiene un due punti (:) nel mezzo della stringa.