Class IsoArchive

Class IsoArchive

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

Représente une archive ISO (ISO 9660).

public sealed class IsoArchive : IArchive, IDisposable

Héritage

objectIsoArchive

Implémente

IArchive, IDisposable

Membres hérités

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

Constructeurs

IsoArchive()

Initialise une nouvelle instance de la classe Aspose.Zip.Iso.IsoArchive et crée une archive ISO vide pour ajouter de nouveaux fichiers et répertoires.

public IsoArchive()

Exemples

L’exemple suivant montre comment créer une nouvelle archive ISO vide et y ajouter des fichiers :

// Créer une nouvelle archive ISO vide
using(IsoArchive isoArchive = new IsoArchive())
{
    // Ajouter des fichiers à l'archive ISO
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Enregistrer l'archive ISO dans un fichier
    isoArchive.Save("new_archive.iso");
}

IsoArchive(Stream, IsoLoadOptions)

Initialise une nouvelle instance de la classe Aspose.Zip.Iso.IsoArchive et compose une liste d’entrées qui peuvent être extraites de l’archive.

public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)

Paramètres

sourceStream Stream

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

loadOptions IsoLoadOptions

Les options pour charger l’archive.

Exemples

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

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

Remarques

Ce constructeur ne décompresse aucune entrée.

Exceptions

ArgumentNullException

sourceStream est nul.

ArgumentException

sourceStream n’est pas accessible par recherche.

InvalidDataException

sourceStream n’est pas une archive ISO valide.

IsoArchive(string, IsoLoadOptions)

Initialise une nouvelle instance de la classe Aspose.Zip.Iso.IsoArchive et compose une liste d’entrées qui peuvent être extraites de l’archive.

public IsoArchive(string path, IsoLoadOptions loadOptions = null)

Paramètres

path string

Le chemin vers le fichier d’archive.

loadOptions IsoLoadOptions

Les options pour charger l’archive.

Exemples

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

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

Remarques

Ce constructeur ne décompresse aucune entrée.

Exceptions

ArgumentNullException

path est nul.

SecurityException

L’appelant n’a pas l’autorisation requise pour accéder.

ArgumentException

Le path est vide, ne contient que des espaces vides, 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 ê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.

EndOfStreamException

Le fichier est trop court.

Propriétés

Entries

Obtient les entrées de type Aspose.Zip.Iso.IsoEntry constituant l’archive.

public ReadOnlyCollection<isoentry> Entries { get; }

Valeur de la propriété

ReadOnlyCollection<IsoEntry&gt;

Méthodes

CreateDirectory(string)

Ajoute un répertoire à l’image ISO.

public IsoEntry CreateDirectory(string name)

Paramètres

name string

Chemin du répertoire dans l’ISO.

Retourne

IsoEntry

L’entrée ISO composée.

Exceptions

InvalidOperationException

L’archive est ouverte pour extraction.

ArgumentNullException

name est nul ou vide.

CreateEntry(string, string)

Ajoute un fichier à l’image ISO.

public IsoEntry CreateEntry(string name, string filePath)

Paramètres

name string

Chemin du fichier dans l’ISO.

filePath string

Chemin du fichier.

Retourne

IsoEntry

L’entrée ISO composée.

Exceptions

ArgumentNullException

Le filePath est nul.

ArgumentException

Le filePath est vide, ne contient que des espaces vides, ou contient des caractères invalides.

UnauthorizedAccessException

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

PathTooLongException

Le filePath spécifié dépasse 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 à filePath contient un deux-points (:) au milieu de la chaîne.

IOException

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

CreateEntry(string, Stream)

Ajoute un fichier à l’image ISO.

public IsoEntry CreateEntry(string name, Stream source)

Paramètres

name string

Chemin du fichier dans l’ISO.

source Stream

Flux contenant les données du fichier.

Retourne

IsoEntry

L’entrée ISO composée.

CreateEntry(string)

Ajoute un fichier à l’image ISO.

public IsoEntry CreateEntry(string name)

Paramètres

name string

Chemin du répertoire dans l’ISO.

Retourne

IsoEntry

L’entrée ISO composée.

Exceptions

ArgumentNullException

name est nul ou vide.

InvalidOperationException

L’archive est ouverte pour extraction.

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

ExtractToDirectory(string)

Extrait toutes les entrées dans le répertoire spécifié.

public void ExtractToDirectory(string destinationDirectory)

Paramètres

destinationDirectory string

Le répertoire dans lequel extraire les entrées.

Exemples

L’exemple suivant montre comment extraire toutes les entrées dans un répertoire :

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

Exceptions

InvalidOperationException

Lancé lorsque l’archive est en mode d’édition.

ArgumentNullException

Lancé lorsque le destinationDirectory est nul.

Save(string, IsoSaveOptions)

Enregistre l’image ISO au chemin spécifié.

public void Save(string path, IsoSaveOptions saveOptions = null)

Paramètres

path string

Le chemin où l’image ISO sera enregistrée.

saveOptions IsoSaveOptions

Options pour enregistrer l’archive ISO.

Exemples

L’exemple suivant montre comment enregistrer une archive ISO dans un fichier :

// Créer une nouvelle archive ISO vide
using(IsoArchive isoArchive = new IsoArchive())
{
    // Ajouter des fichiers à l'archive ISO
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Enregistrer l'archive ISO dans un fichier
    isoArchive.Save("new_archive.iso");
}

Exceptions

InvalidOperationException

Lancé lorsque l’archive n’est pas en mode d’édition.

ArgumentNullException

Lancé lorsque le path est nul.

DirectoryNotFoundException

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

IOException

Lancé lorsque le fichier est déjà ouvert.

UnauthorizedAccessException

Lancé lorsque l’accès au fichier path est refusé.

PathTooLongException

Lancé lorsque le path spécifié dépasse la longueur maximale définie par le système.

Save(Stream, IsoSaveOptions)

Enregistre l’image ISO dans le flux spécifié.

public void Save(Stream stream, IsoSaveOptions saveOptions = null)

Paramètres

stream Stream

Le flux où l’image ISO sera enregistrée.

saveOptions IsoSaveOptions

Options pour enregistrer l’archive ISO.

Exemples

L’exemple suivant montre comment enregistrer une archive ISO dans un flux mémoire :

// Créer une nouvelle archive ISO vide
using(IsoArchive isoArchive = new IsoArchive())
{
    // Ajouter des fichiers à l'archive ISO
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Enregistrer l'archive ISO dans un flux mémoire
    isoArchive.Save(memoryStream);
}

Exceptions

InvalidOperationException

Lancé lorsque l’archive n’est pas en mode d’édition.

ArgumentNullException

Lancé lorsque le stream est nul.

ArgumentException

Lancé lorsque le stream n’est pas inscriptible.

 Français