Class IsoArchive

sourceStream é nulo.

sourceStream não é buscável.

InvalidDataException

sourceStream não é um arquivo ISO válido.

IsoArchive(string, IsoLoadOptions)

Inicializa uma nova instância da classe Aspose.Zip.Iso.IsoArchive e compõe a lista de entradas que podem ser extraídas do arquivo.

public IsoArchive(string path, IsoLoadOptions loadOptions = null)

Parâmetros

path string

O caminho para o arquivo do arquivo.

loadOptions IsoLoadOptions

As opções para carregar o arquivo.

Exemplos

O exemplo a seguir mostra como extrair todas as entradas para um diretório.

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

Observações

Este construtor não desempacota nenhuma entrada.

Exceções

path é nulo.

SecurityException

O chamador não tem a permissão necessária para acessar.

UnauthorizedAccessException

O path está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

Acesso ao arquivo path é negado.

PathTooLongException

O path, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres, e os nomes dos arquivos devem ter menos de 260 caracteres.

NotSupportedException

O arquivo em path contém dois pontos (:) no meio da string.

FileNotFoundException

O arquivo não foi encontrado.

DirectoryNotFoundException

O caminho especificado é inválido, como estar em uma unidade não mapeada.

IOException

O arquivo já está aberto.

EndOfStreamException

O arquivo é muito curto.

Propriedades

Entries

Obtém as entradas do tipo Aspose.Zip.Iso.IsoEntry que constituem o arquivo.

public ReadOnlyCollection<isoentry> Entries { get; }

Valor da Propriedade

ReadOnlyCollection<IsoEntry>

Métodos

CreateDirectory(string)

Adiciona um diretório à imagem ISO.

public IsoEntry CreateDirectory(string name)

Parâmetros

name string

Caminho do diretório na ISO.

Retorna

A entrada ISO composta.

Exceções

O arquivo está aberto para extração.

name é nulo ou vazio.

CreateEntry(string, string)

Adiciona um arquivo à imagem ISO.

public IsoEntry CreateEntry(string name, string filePath)

Parâmetros

name string

Caminho do arquivo na ISO.

filePath string

Caminho do arquivo.

Retorna

A entrada ISO composta.

Exceções

O filePath é nulo.

UnauthorizedAccessException

O filePath está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

Acesso ao arquivo filePath é negado.

PathTooLongException

O filePath especificado excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres, e os nomes dos arquivos devem ter menos de 260 caracteres.

NotSupportedException

O arquivo em filePath contém dois pontos (:) no meio da string.

IOException

Ocorreu um erro de I/O ao abrir o arquivo.

CreateEntry(string, Stream)

Adiciona um arquivo à imagem ISO.

public IsoEntry CreateEntry(string name, Stream source)

Parâmetros

name string

Caminho do arquivo na ISO.

source Stream

Fluxo contendo os dados do arquivo.

Retorna

A entrada ISO composta.

CreateEntry(string)

Adiciona um arquivo à imagem ISO.

public IsoEntry CreateEntry(string name)

Parâmetros

name string

Caminho do diretório na ISO.

Retorna

A entrada ISO composta.

Exceções

name é nulo ou vazio.

O arquivo está aberto para extração.

Dispose()

Executa tarefas definidas pela aplicação associadas à liberação, liberação ou redefinição de recursos não gerenciados.

public void Dispose()

ExtractToDirectory(string)

Extrai todas as entradas para o diretório especificado.

public void ExtractToDirectory(string destinationDirectory)

Parâmetros

destinationDirectory string

O diretório para o qual as entradas serão extraídas.

Exemplos

O exemplo a seguir mostra como extrair todas as entradas para um diretório:

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

Exceções

Lançado quando o arquivo está em modo de edição.

Lançado quando o destinationDirectory é nulo.

Save(string, IsoSaveOptions)

Salva a imagem ISO no caminho especificado.

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

Parâmetros

path string

O caminho onde a imagem ISO será salva.

saveOptions IsoSaveOptions

Opções para salvar o arquivo ISO.

Exemplos

O exemplo a seguir mostra como salvar um arquivo ISO em um arquivo:

// Cria um novo arquivo ISO vazio
using(IsoArchive isoArchive = new IsoArchive())
{
    // Adiciona arquivos ao arquivo ISO
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Salva o arquivo ISO em um arquivo
    isoArchive.Save("new_archive.iso");
}

Exceções

Lançado quando o arquivo não está em modo de edição.

DirectoryNotFoundException

Lançado quando o path é nulo.

Lançado quando o caminho especificado é inválido, como estar em uma unidade não mapeada.

IOException

Lançado quando o arquivo já está aberto.

UnauthorizedAccessException

Lançado quando o acesso ao arquivo path é negado.

PathTooLongException

Lançado quando o path especificado excede o comprimento máximo definido pelo sistema.

Save(Stream, IsoSaveOptions)

Salva a imagem ISO no fluxo especificado.

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

Parâmetros

stream Stream

O fluxo onde a imagem ISO será salva.

saveOptions IsoSaveOptions

Opções para salvar o arquivo ISO.

Exemplos

O exemplo a seguir mostra como salvar um arquivo ISO em um fluxo de memória:

// Cria um novo arquivo ISO vazio
using(IsoArchive isoArchive = new IsoArchive())
{
    // Adiciona arquivos ao arquivo ISO
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Salva o arquivo ISO em um fluxo de memória
    isoArchive.Save(memoryStream);
}

Exceções

Lançado quando o arquivo não está em modo de edição.

Lançado quando o stream é nulo.