Class IsoArchive

Class IsoArchive

Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)

Representa um arquivo ISO (ISO 9660).

public sealed class IsoArchive : IArchive, IDisposable

Herança

objectIsoArchive

Implementa

IArchive, IDisposable

Membros Herdados

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Construtores

IsoArchive()

Inicializa uma nova instância da classe Aspose.Zip.Iso.IsoArchive e cria um arquivo ISO vazio para adicionar novos arquivos e diretórios.

public IsoArchive()

Exemplos

O exemplo a seguir mostra como criar um novo arquivo ISO vazio e adicionar arquivos a ele:

// 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");
}

IsoArchive(Stream, 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(Stream sourceStream, IsoLoadOptions loadOptions = null)

Parâmetros

sourceStream Stream

A fonte do arquivo. Deve ser buscável.

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(File.OpenRead("archive.iso")))
{ 
   archive.ExtractToDirectory("C:\\extracted");
}

Observações

Este construtor não desempacota nenhuma entrada.

Exceções

ArgumentNullException

sourceStream é nulo.

ArgumentException

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

ArgumentNullException

path é nulo.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

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

IsoEntry

A entrada ISO composta.

Exceções

InvalidOperationException

O arquivo está aberto para extração.

ArgumentNullException

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

IsoEntry

A entrada ISO composta.

Exceções

ArgumentNullException

O filePath é nulo.

ArgumentException

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

UnauthorizedAccessException

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

IsoEntry

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

IsoEntry

A entrada ISO composta.

Exceções

ArgumentNullException

name é nulo ou vazio.

InvalidOperationException

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

InvalidOperationException

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

ArgumentNullException

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

InvalidOperationException

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

ArgumentNullException

Lançado quando o path é nulo.

DirectoryNotFoundException

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

InvalidOperationException

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

ArgumentNullException

Lançado quando o stream é nulo.

ArgumentException

Lançado quando o stream não é gravável.

 Português