Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
Representa un archivo ISO (ISO 9660).
public sealed class IsoArchive : IArchive, IDisposableHerencia
Implementa
Miembros heredados
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Constructores
IsoArchive()
Inicializa una nueva instancia de la clase Aspose.Zip.Iso.IsoArchive y crea un archivo ISO vacío para agregar nuevos archivos y directorios.
public IsoArchive()Ejemplos
El siguiente ejemplo muestra cómo crear un nuevo archivo ISO vacío y agregarle archivos:
// Crear un nuevo archivo ISO vacío
using(IsoArchive isoArchive = new IsoArchive())
{
// Agregar archivos al archivo ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Guardar el archivo ISO en un archivo
isoArchive.Save("new_archive.iso");
}IsoArchive(Stream, IsoLoadOptions)
Inicializa una nueva instancia de la clase Aspose.Zip.Iso.IsoArchive y compone una lista de entradas que se pueden extraer del archivo.
public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)Parámetros
sourceStream Stream
La fuente del archivo. Debe ser buscable.
loadOptions IsoLoadOptions
Las opciones para cargar el archivo.
Ejemplos
El siguiente ejemplo muestra cómo extraer todas las entradas a un directorio.
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}Observaciones
Este constructor no descomprime ninguna entrada.
Excepciones
sourceStream es nulo.
sourceStream no es buscable.
sourceStream no es un archivo ISO válido.
IsoArchive(string, IsoLoadOptions)
Inicializa una nueva instancia de la clase Aspose.Zip.Iso.IsoArchive y compone una lista de entradas que se pueden extraer del archivo.
public IsoArchive(string path, IsoLoadOptions loadOptions = null)Parámetros
path string
La ruta al archivo ISO.
loadOptions IsoLoadOptions
Las opciones para cargar el archivo.
Ejemplos
El siguiente ejemplo muestra cómo extraer todas las entradas a un directorio.
using (var archive = new IsoArchive("archive.iso"))
{
archive.ExtractToDirectory("C:\\extracted");
}Observaciones
Este constructor no descomprime ninguna entrada.
Excepciones
path es nulo.
El llamador no tiene el permiso requerido para acceder.
La path está vacía, contiene solo espacios en blanco o contiene caracteres no válidos.
El acceso al archivo path está denegado.
La path, el nombre de archivo o ambos exceden la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.
El archivo en path contiene dos puntos (:) en medio de la cadena.
El archivo no se encuentra.
La ruta especificada no es válida, como estar en una unidad no asignada.
El archivo ya está abierto.
El archivo es demasiado corto.
Propiedades
Entries
Obtiene las entradas del tipo Aspose.Zip.Iso.IsoEntry que constituyen el archivo.
public ReadOnlyCollection<isoentry> Entries { get; }Valor de la propiedad
ReadOnlyCollection<IsoEntry>
Métodos
CreateDirectory(string)
Agrega un directorio a la imagen ISO.
public IsoEntry CreateDirectory(string name)Parámetros
name string
Ruta del directorio en el ISO.
Retorna
La entrada ISO compuesta.
Excepciones
El archivo está abierto para extracción.
name es nulo o vacío.
CreateEntry(string, string)
Agrega un archivo a la imagen ISO.
public IsoEntry CreateEntry(string name, string filePath)Parámetros
name string
Ruta del archivo en el ISO.
filePath string
Ruta del archivo.
Retorna
La entrada ISO compuesta.
Excepciones
La filePath es nula.
La filePath está vacía, contiene solo espacios en blanco o contiene caracteres no válidos.
El acceso al archivo filePath está denegado.
La filePath especificada excede la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.
El archivo en filePath contiene dos puntos (:) en medio de la cadena.
Se produjo un error de E/S al abrir el archivo.
CreateEntry(string, Stream)
Agrega un archivo a la imagen ISO.
public IsoEntry CreateEntry(string name, Stream source)Parámetros
name string
Ruta del archivo en el ISO.
source Stream
Flujo que contiene los datos del archivo.
Retorna
La entrada ISO compuesta.
CreateEntry(string)
Agrega un archivo a la imagen ISO.
public IsoEntry CreateEntry(string name)Parámetros
name string
Ruta del directorio en el ISO.
Retorna
La entrada ISO compuesta.
Excepciones
name es nulo o vacío.
El archivo está abierto para extracción.
Dispose()
Realiza tareas definidas por la aplicación asociadas con la liberación, liberación o reinicio de recursos no administrados.
public void Dispose()ExtractToDirectory(string)
Extrae todas las entradas al directorio especificado.
public void ExtractToDirectory(string destinationDirectory)Parámetros
destinationDirectory string
El directorio al que se extraerán las entradas.
Ejemplos
El siguiente ejemplo muestra cómo extraer todas las entradas a un directorio:
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}Excepciones
Se lanza cuando el archivo está en modo de edición.
Se lanza cuando el destinationDirectory es nulo.
Save(string, IsoSaveOptions)
Guarda la imagen ISO en la ruta especificada.
public void Save(string path, IsoSaveOptions saveOptions = null)Parámetros
path string
La ruta donde se guardará la imagen ISO.
saveOptions IsoSaveOptions
Opciones para guardar el archivo ISO.
Ejemplos
El siguiente ejemplo muestra cómo guardar un archivo ISO en un archivo:
// Crear un nuevo archivo ISO vacío
using(IsoArchive isoArchive = new IsoArchive())
{
// Agregar archivos al archivo ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Guardar el archivo ISO en un archivo
isoArchive.Save("new_archive.iso");
}Excepciones
Se lanza cuando el archivo no está en modo de edición.
Se lanza cuando la path es nula.
Se lanza cuando la ruta especificada no es válida, como estar en una unidad no asignada.
Se lanza cuando el archivo ya está abierto.
Se lanza cuando el acceso al archivo path está denegado.
Se lanza cuando la path especificada excede la longitud máxima definida por el sistema.
Save(Stream, IsoSaveOptions)
Guarda la imagen ISO en el flujo especificado.
public void Save(Stream stream, IsoSaveOptions saveOptions = null)Parámetros
stream Stream
El flujo donde se guardará la imagen ISO.
saveOptions IsoSaveOptions
Opciones para guardar el archivo ISO.
Ejemplos
El siguiente ejemplo muestra cómo guardar un archivo ISO en un flujo de memoria:
// Crear un nuevo archivo ISO vacío
using(IsoArchive isoArchive = new IsoArchive())
{
// Agregar archivos al archivo ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Guardar el archivo ISO en un flujo de memoria
isoArchive.Save(memoryStream);
}Excepciones
Se lanza cuando el archivo no está en modo de edición.
Se lanza cuando el stream es nulo.
Se lanza cuando el stream no es escribible.
