Class IsoArchive

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

objectIsoArchive

Implementa

IArchive, IDisposable

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

ArgumentNullException

sourceStream es nulo.

ArgumentException

sourceStream no es buscable.

InvalidDataException

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

ArgumentNullException

path es nulo.

SecurityException

El llamador no tiene el permiso requerido para acceder.

ArgumentException

La path está vacía, contiene solo espacios en blanco o contiene caracteres no válidos.

UnauthorizedAccessException

El acceso al archivo path está denegado.

PathTooLongException

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.

NotSupportedException

El archivo en path contiene dos puntos (:) en medio de la cadena.

FileNotFoundException

El archivo no se encuentra.

DirectoryNotFoundException

La ruta especificada no es válida, como estar en una unidad no asignada.

IOException

El archivo ya está abierto.

EndOfStreamException

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&gt;

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

IsoEntry

La entrada ISO compuesta.

Excepciones

InvalidOperationException

El archivo está abierto para extracción.

ArgumentNullException

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

IsoEntry

La entrada ISO compuesta.

Excepciones

ArgumentNullException

La filePath es nula.

ArgumentException

La filePath está vacía, contiene solo espacios en blanco o contiene caracteres no válidos.

UnauthorizedAccessException

El acceso al archivo filePath está denegado.

PathTooLongException

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.

NotSupportedException

El archivo en filePath contiene dos puntos (:) en medio de la cadena.

IOException

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

IsoEntry

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

IsoEntry

La entrada ISO compuesta.

Excepciones

ArgumentNullException

name es nulo o vacío.

InvalidOperationException

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

InvalidOperationException

Se lanza cuando el archivo está en modo de edición.

ArgumentNullException

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

InvalidOperationException

Se lanza cuando el archivo no está en modo de edición.

ArgumentNullException

Se lanza cuando la path es nula.

DirectoryNotFoundException

Se lanza cuando la ruta especificada no es válida, como estar en una unidad no asignada.

IOException

Se lanza cuando el archivo ya está abierto.

UnauthorizedAccessException

Se lanza cuando el acceso al archivo path está denegado.

PathTooLongException

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

InvalidOperationException

Se lanza cuando el archivo no está en modo de edición.

ArgumentNullException

Se lanza cuando el stream es nulo.

ArgumentException

Se lanza cuando el stream no es escribible.

 Español