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
Implementa
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
sourceStream
é nulo.
sourceStream
não é buscável.
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.
O chamador não tem a permissão necessária para acessar.
O path
está vazio, contém apenas espaços em branco ou contém caracteres inválidos.
Acesso ao arquivo path
é negado.
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.
O arquivo em path
contém dois pontos (:) no meio da string.
O arquivo não foi encontrado.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo já está aberto.
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.
O filePath
está vazio, contém apenas espaços em branco ou contém caracteres inválidos.
Acesso ao arquivo filePath
é negado.
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.
O arquivo em filePath
contém dois pontos (:) no meio da string.
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.
Lançado quando o path
é nulo.
Lançado quando o caminho especificado é inválido, como estar em uma unidade não mapeada.
Lançado quando o arquivo já está aberto.
Lançado quando o acesso ao arquivo path
é negado.
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.
Lançado quando o stream
não é gravável.