Class IsoArchive

sourceStream è nullo.

sourceStream non è cercabile.

InvalidDataException

sourceStream non è un archivio ISO valido.

IsoArchive(string, IsoLoadOptions)

Inizializza una nuova istanza della classe Aspose.Zip.Iso.IsoArchive e compone l’elenco delle voci che possono essere estratte dall’archivio.

public IsoArchive(string path, IsoLoadOptions loadOptions = null)

Parametri

path string

Il percorso del file dell’archivio.

loadOptions IsoLoadOptions

Le opzioni per caricare l’archivio.

Esempi

Il seguente esempio mostra come estrarre tutte le voci in una directory.

using (var archive = new IsoArchive("archive.iso")) 
{ 
   archive.ExtractToDirectory("C:\\extracted");
}

Osservazioni

Questo costruttore non estrae alcuna voce.

Eccezioni

path è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

UnauthorizedAccessException

Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.

Accesso al file path negato.

PathTooLongException

Il path, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.

NotSupportedException

Il file in path contiene due punti (:) nel mezzo della stringa.

FileNotFoundException

Il file non è trovato.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio se si trova su un’unità non mappata.

IOException

Il file è già aperto.

EndOfStreamException

Il file è troppo corto.

Proprietà

Entries

Ottiene le voci di tipo Aspose.Zip.Iso.IsoEntry che costituiscono l’archivio.

public ReadOnlyCollection<isoentry> Entries { get; }

Valore della Proprietà

ReadOnlyCollection<IsoEntry>

Metodi

CreateDirectory(string)

Aggiunge una directory all’immagine ISO.

public IsoEntry CreateDirectory(string name)

Parametri

name string

Percorso della directory nell’ISO.

Restituisce

L’entrata ISO composta.

Eccezioni

L’archivio è aperto per l’estrazione.

name è nullo o vuoto.

CreateEntry(string, string)

Aggiunge un file all’immagine ISO.

public IsoEntry CreateEntry(string name, string filePath)

Parametri

name string

Percorso del file nell’ISO.

filePath string

Percorso del file.

Restituisce

L’entrata ISO composta.

Eccezioni

Il filePath è nullo.

UnauthorizedAccessException

Il filePath è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.

Accesso al file filePath negato.

PathTooLongException

Il filePath specificato supera la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.

NotSupportedException

Il file in filePath contiene due punti (:) nel mezzo della stringa.

IOException

Si è verificato un errore di I/O durante l’apertura del file.

CreateEntry(string, Stream)

Aggiunge un file all’immagine ISO.

public IsoEntry CreateEntry(string name, Stream source)

Parametri

name string

Percorso del file nell’ISO.

source Stream

Stream contenente i dati del file.

Restituisce

L’entrata ISO composta.

CreateEntry(string)

Aggiunge un file all’immagine ISO.

public IsoEntry CreateEntry(string name)

Parametri

name string

Percorso della directory nell’ISO.

Restituisce

L’entrata ISO composta.

Eccezioni

name è nullo o vuoto.

L’archivio è aperto per l’estrazione.

Dispose()

Esegue attività definite dall’applicazione associate alla liberazione, rilascio o ripristino delle risorse non gestite.

public void Dispose()

ExtractToDirectory(string)

Estrae tutte le voci nella directory specificata.

public void ExtractToDirectory(string destinationDirectory)

Parametri

destinationDirectory string

La directory in cui estrarre le voci.

Esempi

Il seguente esempio mostra come estrarre tutte le voci in una directory:

using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{ 
   archive.ExtractToDirectory("C:\\extracted");
}

Eccezioni

Sollevato quando l’archivio è in modalità di modifica.

Sollevato quando il destinationDirectory è nullo.

Save(string, IsoSaveOptions)

Salva l’immagine ISO nel percorso specificato.

public void Save(string path, IsoSaveOptions saveOptions = null)

Parametri

path string

Il percorso in cui verrà salvata l’immagine ISO.

saveOptions IsoSaveOptions

Opzioni per salvare l’archivio ISO.

Esempi

Il seguente esempio mostra come salvare un archivio ISO in un file:

// Crea un nuovo archivio ISO vuoto
using(IsoArchive isoArchive = new IsoArchive())
{
    // Aggiungi file all'archivio ISO
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Salva l'archivio ISO in un file
    isoArchive.Save("new_archive.iso");
}

Eccezioni

Sollevato quando l’archivio non è in modalità di modifica.

DirectoryNotFoundException

Sollevato quando il path è nullo.

Sollevato quando il percorso specificato non è valido, ad esempio se si trova su un’unità non mappata.

IOException

Sollevato quando il file è già aperto.

UnauthorizedAccessException

Sollevato quando l’accesso al file path è negato.

PathTooLongException

Sollevato quando il path specificato supera la lunghezza massima definita dal sistema.

Save(Stream, IsoSaveOptions)

Salva l’immagine ISO nello stream specificato.

public void Save(Stream stream, IsoSaveOptions saveOptions = null)

Parametri

stream Stream

Lo stream in cui verrà salvata l’immagine ISO.

saveOptions IsoSaveOptions

Opzioni per salvare l’archivio ISO.

Esempi

Il seguente esempio mostra come salvare un archivio ISO in uno stream di memoria:

// Crea un nuovo archivio ISO vuoto
using(IsoArchive isoArchive = new IsoArchive())
{
    // Aggiungi file all'archivio ISO
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Salva l'archivio ISO in uno stream di memoria
    isoArchive.Save(memoryStream);
}

Eccezioni

Sollevato quando l’archivio non è in modalità di modifica.

Sollevato quando il stream è nullo.