Class CabArchive

Class CabArchive

Namespace: Aspose.Zip.Cab
Assembly: Aspose.Zip.dll (25.1.0)

Cette classe représente un fichier d’archive cab.

public class CabArchive : IArchive, IDisposable

Héritage

objectCabArchive

Implémente

IArchive, IDisposable

Membres hérités

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Constructeurs

CabArchive(Stream)

Initialise une nouvelle instance de la classe Aspose.Zip.Cab.CabArchive et compose la liste des entrées pouvant être extraites de l’archive.

public CabArchive(Stream sourceStream)

Paramètres

sourceStream Stream

La source de l’archive. Elle doit être accessible par recherche.

Exemples

L'exemple suivant montre comment extraire toutes les entrées vers un répertoire.

using (var archive = new CabArchive(File.OpenRead("archive.cab")))
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarques

Ce constructeur ne décompresse aucune entrée. Voir la méthode Aspose.Zip.Cab.CabEntry.Open pour la décompression.

Exceptions

ArgumentNullException

sourceStream est nul.

ArgumentException

sourceStream n’est pas accessible par recherche.

InvalidDataException

sourceStream n’est pas un archive cab valide.

EndOfStreamException

Le flux est trop court.

CabArchive(string)

Initialise une nouvelle instance de la classe Aspose.Zip.Cab.CabArchive et compose la liste des entrées pouvant être extraites de l’archive.

public CabArchive(string path)

Paramètres

path string

Le chemin vers le fichier d’archive.

Exemples

L'exemple suivant montre comment extraire toutes les entrées vers un répertoire.

using (var archive = new CabArchive("archive.cab")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarques

Ce constructeur ne décompresse aucune entrée. Voir la méthode Aspose.Zip.Cab.CabEntry.Open 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, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent comporter moins de 248 caractères, et les noms de fichiers moins de 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é n’est pas valide, comme étant sur un lecteur non mappé.

IOException

Le fichier est déjà ouvert.

EndOfStreamException

Le fichier est trop court.

Propriétés

Entries

Obtient les entrées de type Aspose.Zip.Cab.CabEntry constituant l’archive.

public ReadOnlyCollection<cabentry> Entries { get; }

Valeur de la propriété

ReadOnlyCollection<CabEntry&gt;

Méthodes

Dispose(bool)

Effectue des tâches définies par l’application associées à la libération, à la désallocation 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.

Dispose()

Effectue des tâches définies par l’application associées à la libération, à la désallocation ou à la réinitialisation des ressources non gérées.

public void Dispose()

ExtractToDirectory(string)

Extrait tous les fichiers 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.

Exemples

using (var archive = new CabArchive("archive.cab")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarques

Si le répertoire n’existe pas, il sera créé.

Exceptions

ArgumentNullException

path 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.

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

path est une chaîne de longueur nulle, 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- path 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.

InvalidDataException

L’archive est corrompue.

 Français