Class IsoArchive

Class IsoArchive

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

Представляє ISO архів (ISO 9660).

public sealed class IsoArchive : IArchive, IDisposable

Спадкування

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

Зауваження

Цей конструктор не розпаковує жоден запис.

Виключення

ArgumentNullException

sourceStream є null.

ArgumentException

sourceStream не є доступним для переміщення.

InvalidDataException

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

Зауваження

Цей конструктор не розпаковує жоден запис.

Виключення

ArgumentNullException

path є null.

SecurityException

Викликач не має необхідних дозволів для доступу.

ArgumentException

path є порожнім, містить лише пробіли або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path заборонено.

PathTooLongException

Вказаний path, ім’я файлу або обидва перевищують максимально допустиму довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл за path містить двокрапку (:) посередині рядка.

FileNotFoundException

Файл не знайдено.

DirectoryNotFoundException

Вказаний шлях є недійсним, наприклад, знаходиться на не відображеному диску.

IOException

Файл вже відкритий.

EndOfStreamException

Файл занадто короткий.

Властивості

Entries

Отримує записи типу Aspose.Zip.Iso.IsoEntry, які складають архів.

public ReadOnlyCollection<isoentry> Entries { get; }

Значення властивості

ReadOnlyCollection<IsoEntry&gt;

Методи

CreateDirectory(string)

Додає каталог до ISO образу.

public IsoEntry CreateDirectory(string name)

Параметри

name string

Шлях до каталогу в ISO.

Повертає

IsoEntry

Складений ISO запис.

Виключення

InvalidOperationException

Архів відкритий для витягнення.

ArgumentNullException

name є null або порожнім.

CreateEntry(string, string)

Додає файл до ISO образу.

public IsoEntry CreateEntry(string name, string filePath)

Параметри

name string

Шлях до файлу в ISO.

filePath string

Шлях до файлу.

Повертає

IsoEntry

Складений ISO запис.

Виключення

ArgumentNullException

filePath є null.

ArgumentException

filePath є порожнім, містить лише пробіли або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу filePath заборонено.

PathTooLongException

Вказаний filePath перевищує максимально допустиму довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл за filePath містить двокрапку (:) посередині рядка.

IOException

Виникла помилка вводу/виводу під час відкриття файлу.

CreateEntry(string, Stream)

Додає файл до ISO образу.

public IsoEntry CreateEntry(string name, Stream source)

Параметри

name string

Шлях до файлу в ISO.

source Stream

Потік, що містить дані файлу.

Повертає

IsoEntry

Складений ISO запис.

CreateEntry(string)

Додає файл до ISO образу.

public IsoEntry CreateEntry(string name)

Параметри

name string

Шлях до каталогу в ISO.

Повертає

IsoEntry

Складений ISO запис.

Виключення

ArgumentNullException

name є null або порожнім.

InvalidOperationException

Архів відкритий для витягнення.

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

Виключення

InvalidOperationException

Викидається, коли архів у режимі редагування.

ArgumentNullException

Викидається, коли 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");
}

Виключення

InvalidOperationException

Викидається, коли архів не в режимі редагування.

ArgumentNullException

Викидається, коли path є null.

DirectoryNotFoundException

Викидається, коли вказаний шлях є недійсним, наприклад, знаходиться на не відображеному диску.

IOException

Викидається, коли файл вже відкритий.

UnauthorizedAccessException

Викидається, коли доступ до файлу path заборонено.

PathTooLongException

Викидається, коли вказаний 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);
}

Виключення

InvalidOperationException

Викидається, коли архів не в режимі редагування.

ArgumentNullException

Викидається, коли stream є null.

ArgumentException

Викидається, коли stream не є записуваним.

 Українська