Class IsoArchive

sourceStream est nul.

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

path est nul.

SecurityException

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

UnauthorizedAccessException

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

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>

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

L’entrée ISO composée.

Exceptions

L’archive est ouverte pour extraction.

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

L’entrée ISO composée.

Exceptions

Le filePath est nul.

UnauthorizedAccessException

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

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

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

L’entrée ISO composée.

Exceptions

name est nul ou vide.

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

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

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

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

DirectoryNotFoundException

Lancé lorsque le path est nul.

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

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

Lancé lorsque le stream est nul.