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
Implémente
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
sourceStream
est nul.
sourceStream
n’est pas accessible par recherche.
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.
L’appelant n’a pas l’autorisation requise pour accéder.
Le path
est vide, ne contient que des espaces vides, ou contient des caractères invalides.
L’accès au fichier path
est refusé.
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.
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.
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.
Le filePath
est vide, ne contient que des espaces vides, ou contient des caractères invalides.
L’accès au fichier filePath
est refusé.
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.
Le fichier à filePath
contient un deux-points (:) au milieu de la chaîne.
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.
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é.
Lancé lorsque le fichier est déjà ouvert.
Lancé lorsque l’accès au fichier path
est refusé.
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.
Lancé lorsque le stream
n’est pas inscriptible.