Class CabArchive
Namespace: Aspose.Zip.Cab
Assembly: Aspose.Zip.dll (25.1.0)
این کلاس نمایانگر فایل آرشیو cab است.
public class CabArchive : IArchive, IDisposableوراثت
پیاده‌سازی‌ها
اعضای وراثت‌یافته
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
سازنده‌ها
CabArchive(Stream)
یک نمونه جدید از کلاس Aspose.Zip.Cab.CabArchive را راه‌اندازی کرده و لیست ورودی‌هایی که می‌توان از آرشیو استخراج کرد را تشکیل می‌دهد.
public CabArchive(Stream sourceStream)پارامترها
sourceStream Stream
منبع آرشیو. باید قابل جستجو باشد.
مثال‌ها
مثال زیر نشان می‌دهد که چگونه می‌توان تمام ورودی‌ها را به یک دایرکتوری استخراج کرد.
using (var archive = new CabArchive(File.OpenRead("archive.cab")))
{
archive.ExtractToDirectory("C:\extracted");
}توضیحات
این سازنده هیچ ورودی‌ای را unpack نمی‌کند. برای unpack کردن، به متد Aspose.Zip.Cab.CabEntry.Open مراجعه کنید.
استثناها
sourceStream نال است.
sourceStream قابل جستجو نیست.
sourceStream یک آرشیو cab معتبر نیست.
جریان خیلی کوتاه است.
CabArchive(string)
یک نمونه جدید از کلاس Aspose.Zip.Cab.CabArchive را راه‌اندازی کرده و لیست ورودی‌هایی که می‌توان از آرشیو استخراج کرد را تشکیل می‌دهد.
public CabArchive(string path)پارامترها
path string
مسیر فایل آرشیو.
مثال‌ها
مثال زیر نشان می‌دهد که چگونه می‌توان تمام ورودی‌ها را به یک دایرکتوری استخراج کرد.
using (var archive = new CabArchive("archive.cab"))
{
archive.ExtractToDirectory("C:\extracted");
}توضیحات
این سازنده هیچ ورودی‌ای را unpack نمی‌کند. برای unpack کردن، به متد Aspose.Zip.Cab.CabEntry.Open مراجعه کنید.
استثناها
path نال است.
تماس‌گیرنده مجوز لازم برای دسترسی را ندارد.
path خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path ممنوع است.
path، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم تجاوز می‌کند. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.
فایل در path شامل دو نقطه (:) در وسط رشته است.
فایل پیدا نشد.
مسیر مشخص‌شده نامعتبر است، مانند اینکه در یک درایو غیرنقشه‌برداری باشد.
فایل قبلاً باز است.
فایل خیلی کوتاه است.
ویژگی‌ها
Entries
ورودی‌های نوع Aspose.Zip.Cab.CabEntry که آرشیو را تشکیل می‌دهند، دریافت می‌کند.
public ReadOnlyCollection<cabentry> Entries { get; }مقدار ویژگی
ReadOnlyCollection<CabEntry>
متدها
Dispose(bool)
وظایف تعریف‌شده توسط برنامه را که با آزادسازی، رها کردن یا بازنشانی منابع غیرمدیریتی مرتبط است، انجام می‌دهد.
protected virtual void Dispose(bool disposing)پارامترها
disposing bool
آیا منابع مدیریت‌شده باید رها شوند یا خیر.
Dispose()
وظایف تعریف‌شده توسط برنامه را که با آزادسازی، رها کردن یا بازنشانی منابع غیرمدیریتی مرتبط است، انجام می‌دهد.
public void Dispose()ExtractToDirectory(string)
تمام فایل‌ها را در آرشیو به دایرکتوری ارائه‌شده استخراج می‌کند.
public void ExtractToDirectory(string destinationDirectory)پارامترها
destinationDirectory string
مسیر دایرکتوری برای قرار دادن فایل‌های استخراج‌شده.
مثال‌ها
using (var archive = new CabArchive("archive.cab"))
{
archive.ExtractToDirectory("C:\extracted");
}توضیحات
اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.
استثناها
path نال است.
مسیر مشخص‌شده، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم تجاوز می‌کند.
تماس‌گیرنده مجوز لازم برای دسترسی به دایرکتوری موجود را ندارد.
اگر دایرکتوری وجود نداشته باشد، مسیر شامل کاراکتر دو نقطه (:) است که بخشی از برچسب درایو نیست (“C:") .
path یک رشته با طول صفر است، فقط شامل فضاهای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است. می‌توانید با استفاده از متد System.IO.Path.GetInvalidPathChars کاراکترهای نامعتبر را جستجو کنید. -یا- path با کاراکتر دو نقطه (:) پیشوند یا فقط شامل کاراکتر دو نقطه است.
دایرکتوری مشخص‌شده توسط path یک فایل است. -یا- نام شبکه شناخته‌شده نیست.
آرشیو خراب است.
