Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
Представляет ISO-архив (ISO 9660).
public sealed class IsoArchive : IArchive, IDisposableНаследование
Реализует
Унаследованные члены
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Конструкторы
IsoArchive()
Инициализирует новый экземпляр класса Aspose.Zip.Iso.IsoArchive и создает пустой ISO-архив для добавления новых файлов и каталогов.
public IsoArchive()Примеры
Следующий пример показывает, как создать новый пустой ISO-архив и добавить в него файлы:
// Создание нового пустого ISO-архива
using(IsoArchive isoArchive = new IsoArchive())
{
// Добавление файлов в ISO-архив
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Сохранение ISO-архива в файл
isoArchive.Save("new_archive.iso");
}IsoArchive(Stream, IsoLoadOptions)
Инициализирует новый экземпляр класса Aspose.Zip.Iso.IsoArchive и формирует список записей, которые можно извлечь из архива.
public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)Параметры
sourceStream Stream
Источник архива. Он должен поддерживать перемещение.
loadOptions IsoLoadOptions
Опции для загрузки архива.
Примеры
Следующий пример показывает, как извлечь все записи в каталог.
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}Примечания
Этот конструктор не распаковывает ни одну запись.
Исключения
sourceStream равен null.
sourceStream не поддерживает перемещение.
sourceStream не является действительным ISO-архивом.
IsoArchive(string, IsoLoadOptions)
Инициализирует новый экземпляр класса Aspose.Zip.Iso.IsoArchive и формирует список записей, которые можно извлечь из архива.
public IsoArchive(string path, IsoLoadOptions loadOptions = null)Параметры
path string
Путь к файлу архива.
loadOptions IsoLoadOptions
Опции для загрузки архива.
Примеры
Следующий пример показывает, как извлечь все записи в каталог.
using (var archive = new IsoArchive("archive.iso"))
{
archive.ExtractToDirectory("C:\\extracted");
}Примечания
Этот конструктор не распаковывает ни одну запись.
Исключения
path равен null.
У вызывающего нет необходимых прав для доступа.
path пуст, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу path запрещен.
Указанный path, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов должны быть короче 260 символов.
Файл по адресу path содержит двоеточие (:) в середине строки.
Файл не найден.
Указанный путь недействителен, например, находится на не смонтированном диске.
Файл уже открыт.
Файл слишком короткий.
Свойства
Entries
Получает записи типа Aspose.Zip.Iso.IsoEntry, составляющие архив.
public ReadOnlyCollection<isoentry> Entries { get; }Значение свойства
ReadOnlyCollection<IsoEntry>
Методы
CreateDirectory(string)
Добавляет каталог в ISO-образ.
public IsoEntry CreateDirectory(string name)Параметры
name string
Путь к каталогу в ISO.
Возвращает
Составленная запись ISO.
Исключения
Архив открыт для извлечения.
name равен null или пуст.
CreateEntry(string, string)
Добавляет файл в ISO-образ.
public IsoEntry CreateEntry(string name, string filePath)Параметры
name string
Путь к файлу в ISO.
filePath string
Путь к файлу.
Возвращает
Составленная запись ISO.
Исключения
filePath равен null.
filePath пуст, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу filePath запрещен.
Указанный filePath превышает максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов должны быть короче 260 символов.
Файл по адресу filePath содержит двоеточие (:) в середине строки.
Произошла ошибка ввода-вывода при открытии файла.
CreateEntry(string, Stream)
Добавляет файл в ISO-образ.
public IsoEntry CreateEntry(string name, Stream source)Параметры
name string
Путь к файлу в ISO.
source Stream
Поток, содержащий данные файла.
Возвращает
Составленная запись ISO.
CreateEntry(string)
Добавляет файл в ISO-образ.
public IsoEntry CreateEntry(string name)Параметры
name string
Путь к каталогу в ISO.
Возвращает
Составленная запись ISO.
Исключения
name равен null или пуст.
Архив открыт для извлечения.
Dispose()
Выполняет задачи, определенные приложением, связанные с освобождением, освобождением или сбросом неуправляемых ресурсов.
public void Dispose()ExtractToDirectory(string)
Извлекает все записи в указанный каталог.
public void ExtractToDirectory(string destinationDirectory)Параметры
destinationDirectory string
Каталог, в который будут извлечены записи.
Примеры
Следующий пример показывает, как извлечь все записи в каталог:
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}Исключения
Выбрасывается, когда архив находится в режиме редактирования.
Выбрасывается, когда destinationDirectory равен null.
Save(string, IsoSaveOptions)
Сохраняет ISO-образ в указанном пути.
public void Save(string path, IsoSaveOptions saveOptions = null)Параметры
path string
Путь, по которому будет сохранен ISO-образ.
saveOptions IsoSaveOptions
Опции для сохранения ISO-архива.
Примеры
Следующий пример показывает, как сохранить ISO-архив в файл:
// Создание нового пустого ISO-архива
using(IsoArchive isoArchive = new IsoArchive())
{
// Добавление файлов в ISO-архив
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Сохранение ISO-архива в файл
isoArchive.Save("new_archive.iso");
}Исключения
Выбрасывается, когда архив не находится в режиме редактирования.
Выбрасывается, когда path равен null.
Выбрасывается, когда указанный путь недействителен, например, находится на не смонтированном диске.
Выбрасывается, когда файл уже открыт.
Выбрасывается, когда доступ к файлу path запрещен.
Выбрасывается, когда указанный path превышает максимальную длину, определенную системой.
Save(Stream, IsoSaveOptions)
Сохраняет ISO-образ в указанный поток.
public void Save(Stream stream, IsoSaveOptions saveOptions = null)Параметры
stream Stream
Поток, в который будет сохранен ISO-образ.
saveOptions IsoSaveOptions
Опции для сохранения ISO-архива.
Примеры
Следующий пример показывает, как сохранить ISO-архив в поток памяти:
// Создание нового пустого ISO-архива
using(IsoArchive isoArchive = new IsoArchive())
{
// Добавление файлов в ISO-архив
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Сохранение ISO-архива в поток памяти
isoArchive.Save(memoryStream);
}Исключения
Выбрасывается, когда архив не находится в режиме редактирования.
Выбрасывается, когда stream равен null.
Выбрасывается, когда stream не поддерживает запись.
