Class LzipArchive

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

objectLzipArchive

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

ArgumentException

sourceStream n’est pas seekable.

ArgumentNullException

sourceStream est nul.

InvalidDataException

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

ArgumentNullException

path est nul.

SecurityException

L’appelant n’a pas la permission requise pour accéder.

ArgumentException

Le path est vide, contient uniquement des espaces blancs ou contient des caractères invalides.

UnauthorizedAccessException

L’accès au fichier path est refusé.

PathTooLongException

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.

NotSupportedException

Le fichier à path contient un deux-points (:) au milieu de la chaîne.

FileNotFoundException

Le fichier est introuvable.

DirectoryNotFoundException

Le chemin spécifié est invalide, par exemple s’il se trouve sur un lecteur non mappé.

IOException

Le fichier est déjà ouvert.

InvalidDataException

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é

LzipArchiveSettings

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

InvalidOperationException

Les en-têtes de l’archive et les informations de service n’ont pas été lues.

InvalidDataException

Erreur dans les données de l’en-tête ou somme de contrôle.

ArgumentNullException

Le flux de destination est nul.

ArgumentException

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

InvalidOperationException

Les en-têtes de l’archive et les informations de service n’ont pas été lues.

SecurityException

L’appelant n’a pas la permission requise pour ouvrir le fileInfo.

ArgumentException

Le chemin du fichier est vide ou contient uniquement des espaces blancs.

FileNotFoundException

Le fichier est introuvable.

UnauthorizedAccessException

Le chemin vers le fichier est en lecture seule ou est un répertoire.

ArgumentNullException

fileInfo est nul.

DirectoryNotFoundException

Le chemin spécifié est invalide, par exemple s’il se trouve sur un lecteur non mappé.

IOException

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

InvalidOperationException

Les en-têtes de l’archive et les informations de service n’ont pas été lues.

ArgumentNullException

path est nul.

SecurityException

L’appelant n’a pas la permission requise pour accéder.

ArgumentException

Le path est vide, contient uniquement des espaces blancs, ou contient des caractères invalides.

UnauthorizedAccessException

L’accès au fichier path est refusé.

PathTooLongException

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.

NotSupportedException

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

ArgumentNullException

destinationDirectory est nul.

PathTooLongException

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.

SecurityException

L’appelant n’a pas la permission requise pour accéder au répertoire existant.

NotSupportedException

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:").

ArgumentException

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 (:).

IOException

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

ArgumentException

outputStream ne prend pas en charge la recherche.

ArgumentNullException

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

ArgumentNullException

destinationFileName est nul.

SecurityException

L’appelant n’a pas la permission requise pour accéder.

ArgumentException

Le destinationFileName est vide, contient uniquement des espaces blancs, ou contient des caractères invalides.

UnauthorizedAccessException

L’accès au fichier destinationFileName est refusé.

PathTooLongException

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.

NotSupportedException

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

SecurityException

L’appelant n’a pas la permission requise pour ouvrir le destination.

ArgumentException

Le chemin du fichier est vide ou contient uniquement des espaces blancs.

FileNotFoundException

Le fichier est introuvable.

UnauthorizedAccessException

Le chemin vers le fichier est en lecture seule ou est un répertoire.

ArgumentNullException

destination est nul.

DirectoryNotFoundException

Le chemin spécifié est invalide, par exemple s’il se trouve sur un lecteur non mappé.

IOException

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

ArgumentException

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

SecurityException

L’appelant n’a pas la permission requise pour ouvrir le fileInfo.

ArgumentException

Le chemin du fichier est vide ou contient uniquement des espaces blancs.

FileNotFoundException

Le fichier est introuvable.

UnauthorizedAccessException

Le chemin vers le fichier est en lecture seule ou est un répertoire.

ArgumentNullException

fileInfo est nul.

DirectoryNotFoundException

Le chemin spécifié est invalide, par exemple s’il se trouve sur un lecteur non mappé.

IOException

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

ArgumentNullException

path est nul.

SecurityException

L’appelant n’a pas la permission requise pour accéder.

ArgumentException

Le path est vide, contient uniquement des espaces blancs, ou contient des caractères invalides.

UnauthorizedAccessException

L’accès au fichier path est refusé.

PathTooLongException

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.

NotSupportedException

Le fichier à path contient un deux-points (:) au milieu de la chaîne.

 Français