Class LzipArchive
Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)
Cette classe représente un fichier d’archive Lzip. Utilisez-la pour composer ou extraire des archives Lzip.
public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry
Héritage
Implémente
IArchive, IDisposable, IArchiveFileEntry
Membres hérités
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Constructeurs
LzipArchive(LzipArchiveSettings)
Initialise une nouvelle instance de Aspose.Zip.Lzip.LzipArchive.
public LzipArchive(LzipArchiveSettings settings = null)
Paramètres
settings
LzipArchiveSettings
Réglage de l’archive lzip particulière avec définition de la taille du dictionnaire.
LzipArchive(Stream)
Initialise une nouvelle instance de la classe Aspose.Zip.Lzip.LzipArchive préparée pour la décompression.
public LzipArchive(Stream sourceStream)
Paramètres
sourceStream
Stream
La source de l’archive.
Remarques
Ce constructeur ne décompresse pas. Voir la méthode Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) pour la décompression.
Exceptions
sourceStream
n’est pas seekable.
sourceStream
est nul.
Les en-têtes ne correspondent pas au type d’archive lzip.
LzipArchive(string)
Initialise une nouvelle instance de la classe Aspose.Zip.Lzip.LzipArchive préparée pour la décompression.
public LzipArchive(string path)
Paramètres
path
string
Chemin vers la source de l’archive.
Exemples
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzipArchive(sourceLzipFile))
{
archive.Extract(extractedFile);
}
}
Remarques
Ce constructeur ne décompresse pas. Voir la méthode Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) pour la décompression.
Exceptions
path
est nul.
L’appelant n’a pas la permission requise pour accéder.
Le path
est vide, contient uniquement des espaces blancs ou contient des caractères invalides.
L’accès au fichier path
est refusé.
Le path
, le nom de fichier spécifié, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.
Le fichier à path
contient un deux-points (:) au milieu de la chaîne.
Le fichier est introuvable.
Le chemin spécifié est invalide, par exemple s’il se trouve sur un lecteur non mappé.
Le fichier est déjà ouvert.
Les en-têtes ne correspondent pas au type d’archive lzip.
Propriétés
Settings
Obtient le réglage de l’archive lzip particulière.
public LzipArchiveSettings Settings { get; }
Valeur de la propriété
Méthodes
Dispose()
Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non gérées.
public void Dispose()
Dispose(bool)
Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non gérées.
protected virtual void Dispose(bool disposing)
Paramètres
disposing
bool
Indique si les ressources gérées doivent être libérées.
Extract(Stream)
Extrait l’archive lzip vers un flux.
public void Extract(Stream destination)
Paramètres
destination
Stream
Flux pour stocker les données décompressées.
Exemples
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);
}
}
}
Exceptions
Les en-têtes de l’archive et les informations de service n’ont pas été lues.
Erreur dans les données de l’en-tête ou somme de contrôle.
Le flux de destination est nul.
Le flux de destination ne prend pas en charge l’écriture.
Extract(FileInfo)
Extrait l’archive lzip vers un fichier.
public void Extract(FileInfo fileInfo)
Paramètres
fileInfo
FileInfo
FileInfo pour stocker les données décompressées.
Exemples
using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzipArchive(lzipFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Exceptions
Les en-têtes de l’archive et les informations de service n’ont pas été lues.
L’appelant n’a pas la permission requise pour ouvrir le fileInfo
.
Le chemin du fichier est vide ou contient uniquement des espaces blancs.
Le fichier est introuvable.
Le chemin vers le fichier est en lecture seule ou est un répertoire.
fileInfo
est nul.
Le chemin spécifié est invalide, par exemple s’il se trouve sur un lecteur non mappé.
Le fichier est déjà ouvert.
Extract(string)
Extrait l’archive lzip vers un fichier par chemin.
public void Extract(string path)
Paramètres
path
string
Chemin vers le fichier qui stockera les données décompressées.
Exemples
using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzipArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}
Exceptions
Les en-têtes de l’archive et les informations de service n’ont pas été lues.
path
est nul.
L’appelant n’a pas la permission requise pour accéder.
Le path
est vide, contient uniquement des espaces blancs, ou contient des caractères invalides.
L’accès au fichier path
est refusé.
Le path
, le nom de fichier spécifié, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.
Le fichier à path
contient un deux-points (:) au milieu de la chaîne.
ExtractToDirectory(string)
Extrait le contenu de l’archive vers le répertoire fourni.
public void ExtractToDirectory(string destinationDirectory)
Paramètres
destinationDirectory
string
Le chemin vers le répertoire où placer les fichiers extraits.
Remarques
Si le répertoire n’existe pas, il sera créé.
Exceptions
destinationDirectory
est nul.
Le chemin spécifié, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent être inférieurs à 248 caractères et les noms de fichiers doivent être inférieurs à 260 caractères.
L’appelant n’a pas la permission requise pour accéder au répertoire existant.
Si le répertoire n’existe pas, le chemin contient un caractère deux-points (:) qui ne fait pas partie d’une étiquette de lecteur (“C:").
destinationDirectory
est une chaîne de longueur zéro, contient uniquement des espaces blancs, ou contient un ou plusieurs caractères invalides. Vous pouvez interroger les caractères invalides en utilisant la méthode System.IO.Path.GetInvalidPathChars.
-ou- le chemin est préfixé par, ou contient, uniquement un caractère deux-points (:).
Le répertoire spécifié par le chemin est un fichier. -ou- Le nom du réseau n’est pas connu.
Save(Stream)
Sauvegarde l’archive lzip vers le flux fourni.
public void Save(Stream outputStream)
Paramètres
outputStream
Stream
Flux de destination.
Exemples
using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save(lzFile);
}
}
Remarques
outputStream
doit être seekable.
Exceptions
outputStream
ne prend pas en charge la recherche.
outputStream
est nul.
Save(string)
Sauvegarde l’archive lzip vers le fichier de destination fourni.
public void Save(string destinationFileName)
Paramètres
destinationFileName
string
Le chemin de l’archive à créer. Si le nom de fichier spécifié pointe vers un fichier existant, il sera écrasé.
Exemples
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lz");
}
Exceptions
destinationFileName
est nul.
L’appelant n’a pas la permission requise pour accéder.
Le destinationFileName
est vide, contient uniquement des espaces blancs, ou contient des caractères invalides.
L’accès au fichier destinationFileName
est refusé.
Le destinationFileName
, le nom de fichier spécifié, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.
Le fichier à destinationFileName
contient un deux-points (:) au milieu de la chaîne.
Save(FileInfo)
Sauvegarde l’archive lzip vers le fichier de destination fourni.
public void Save(FileInfo destination)
Paramètres
destination
FileInfo
FileInfo qui sera ouvert comme flux de destination.
Exemples
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lz"));
}
Exceptions
L’appelant n’a pas la permission requise pour ouvrir le destination
.
Le chemin du fichier est vide ou contient uniquement des espaces blancs.
Le fichier est introuvable.
Le chemin vers le fichier est en lecture seule ou est un répertoire.
destination
est nul.
Le chemin spécifié est invalide, par exemple s’il se trouve sur un lecteur non mappé.
Le fichier est déjà ouvert.
SetSource(Stream)
Définit le contenu à compresser dans l’archive.
public void SetSource(Stream source)
Paramètres
source
Stream
Le flux d’entrée pour l’archive.
Exemples
using (var archive = new LzipArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz");
}
Exceptions
Le flux source
est non seekable.
SetSource(FileInfo)
Définit le contenu à compresser dans l’archive.
public void SetSource(FileInfo fileInfo)
Paramètres
fileInfo
FileInfo
FileInfo qui sera ouvert comme flux d’entrée.
Exemples
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lz");
}
Exceptions
L’appelant n’a pas la permission requise pour ouvrir le fileInfo
.
Le chemin du fichier est vide ou contient uniquement des espaces blancs.
Le fichier est introuvable.
Le chemin vers le fichier est en lecture seule ou est un répertoire.
fileInfo
est nul.
Le chemin spécifié est invalide, par exemple s’il se trouve sur un lecteur non mappé.
Le fichier est déjà ouvert.
SetSource(string)
Définit le contenu à compresser dans l’archive.
public void SetSource(string path)
Paramètres
path
string
Chemin vers le fichier à compresser.
Exemples
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz");
}
Exceptions
path
est nul.
L’appelant n’a pas la permission requise pour accéder.
Le path
est vide, contient uniquement des espaces blancs, ou contient des caractères invalides.
L’accès au fichier path
est refusé.
Le path
, le nom de fichier spécifié, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.
Le fichier à path
contient un deux-points (:) au milieu de la chaîne.