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");
}
توضیحات
این سازنده هیچ ورودیای را unpack نمیکند.
استثناها
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");
}
توضیحات
این سازنده هیچ ورودیای را unpack نمیکند.
استثناها
path
null است.
فراخوانیکننده اجازه لازم برای دسترسی را ندارد.
path
خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path
رد شده است.
path
مشخص شده، نام فایل، یا هر دو از طول حداکثر تعریف شده توسط سیستم فراتر رفتهاند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 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
مشخص شده از طول حداکثر تعریف شده توسط سیستم فراتر رفته است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشد.
فایل در filePath
شامل یک دو نقطه (:) در وسط رشته است.
یک خطای I/O در حین باز کردن فایل رخ داده است.
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
قابل نوشتن نباشد.