Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
Representa un archivo ISO (ISO 9660).
public sealed class IsoArchive : IArchive, IDisposable
Herencia
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.