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

توضیحات

این سازنده هیچ ورودی‌ای را unpack نمی‌کند.

استثناها

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

توضیحات

این سازنده هیچ ورودی‌ای را unpack نمی‌کند.

استثناها

ArgumentNullException

path null است.

SecurityException

فراخوانی‌کننده اجازه لازم برای دسترسی را ندارد.

ArgumentException

path خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.

UnauthorizedAccessException

دسترسی به فایل path رد شده است.

PathTooLongException

path مشخص شده، نام فایل، یا هر دو از طول حداکثر تعریف شده توسط سیستم فراتر رفته‌اند. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 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 مشخص شده از طول حداکثر تعریف شده توسط سیستم فراتر رفته است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در filePath شامل یک دو نقطه (:) در وسط رشته است.

IOException

یک خطای I/O در حین باز کردن فایل رخ داده است.

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 قابل نوشتن نباشد.