Class ZArchive

source قابل جستجو نیست.

source تهی است.

ZArchive(string, ZArchiveLoadOptions)

یک نمونه جدید از کلاس Aspose.Zip.Z.ZArchive را برای استخراج آماده می‌کند.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

پارامترها

path string

مسیر به منبع آرشیو.

loadOptions ZArchiveLoadOptions

گزینه‌ها برای بارگذاری آرشیو.

توضیحات

این سازنده فشرده‌سازی نمی‌کند. برای فشرده‌سازی به متد Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) مراجعه کنید.

استثناها

path تهی است.

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

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

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

path، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.

DirectoryNotFoundException

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

FileNotFoundException

فایل یافت نشد.

مسیر مشخص‌شده نامعتبر است، مانند اینکه در یک درایو نام‌گذاری نشده است.

فایل قبلاً باز شده است.

متدها

Dispose()

وظایف تعریف‌شده توسط برنامه را برای آزادسازی، رها کردن یا بازنشانی منابع غیرمدیریتی انجام می‌دهد.

public void Dispose()

Dispose(bool)

وظایف تعریف‌شده توسط برنامه را برای آزادسازی، رها کردن یا بازنشانی منابع غیرمدیریتی انجام می‌دهد.

protected virtual void Dispose(bool disposing)

پارامترها

disposing bool

آیا منابع مدیریت‌شده باید آزاد شوند.

Extract(Stream)

آرشیو Z را به یک جریان استخراج می‌کند.

public void Extract(Stream destination)

پارامترها

destination Stream

جریان برای ذخیره‌سازی داده‌های فشرده‌نشده.

مثال‌ها

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new ZArchive(zFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

استثناها

InvalidDataException

داده‌ها نمی‌توانند فشرده‌سازی شوند.

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

FileInfo برای ذخیره‌سازی داده‌های فشرده‌نشده.

مثال‌ها

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

استثناها

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

مسیر فایل خالی است یا فقط شامل فضاهای خالی است.

FileNotFoundException

فایل یافت نشد.

مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.

DirectoryNotFoundException

fileInfo تهی است.

مسیر مشخص‌شده نامعتبر است، مانند اینکه در یک درایو نام‌گذاری نشده است.

فایل قبلاً باز شده است.

InvalidDataException

داده‌ها نمی‌توانند فشرده‌سازی شوند.

Extract(string)

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

public FileInfo Extract(string path)

پارامترها

path string

مسیر به فایلی که داده‌های فشرده‌نشده را ذخیره می‌کند.

بازگشت

FileInfo

اطلاعات فایل استخراج‌شده.

مثال‌ها

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

استثناها

path تهی است.

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

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

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

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

InvalidDataException

داده‌ها نمی‌توانند فشرده‌سازی شوند.

ExtractToDirectory(string)

محتویات آرشیو را به دایرکتوری مشخص‌شده استخراج می‌کند.

public void ExtractToDirectory(string destinationDirectory)

پارامترها

destinationDirectory string

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

توضیحات

اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.

استثناها

destinationDirectory تهی است.

destinationDirectory، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.

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

اگر دایرکتوری وجود نداشته باشد، مسیر شامل یک کاراکتر دو نقطه (:) است که بخشی از برچسب درایو نیست (“C:") .

destinationDirectory یک رشته با طول صفر است، فقط شامل فضاهای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است. می‌توانید با استفاده از متد System.IO.Path.GetInvalidPathChars کاراکترهای نامعتبر را جستجو کنید. - یا - مسیر با یک کاراکتر دو نقطه (:) پیشوند یا فقط شامل آن است.

دایرکتوری مشخص‌شده توسط مسیر یک فایل است. - یا - نام شبکه ناشناخته است.

Save(Stream, ZArchiveSaveOptions)

آرشیو xz را به جریان ارائه‌شده ذخیره می‌کند.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

پارامترها

output Stream

جریان مقصد.

settings ZArchiveSaveOptions

تنظیمات اختیاری برای ترکیب آرشیو.

مثال‌ها

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

توضیحات

output باید قابل جستجو باشد.

استثناها

output از جستجو پشتیبانی نمی‌کند.

output تهی است.

Save(string, ZArchiveSaveOptions)

آرشیو Z را به فایل مقصد ارائه‌شده ذخیره می‌کند.

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

پارامترها

destinationFileName string

+مسیر آرشیو که باید ایجاد شود. اگر نام فایل مشخص‌شده به یک فایل موجود اشاره کند، آن فایل بازنویسی خواهد شد.

settings ZArchiveSaveOptions

تنظیمات اختیاری برای ترکیب آرشیو.

مثال‌ها

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

استثناها

destinationFileName تهی است.

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

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

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

destinationFileName، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.

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

SetSource(Stream)

محتویات را برای فشرده‌سازی درون آرشیو تنظیم می‌کند.

public void SetSource(Stream source)

پارامترها

source Stream

جریان ورودی برای آرشیو.

مثال‌ها

using (var archive = new ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

محتویات را برای فشرده‌سازی درون آرشیو تنظیم می‌کند.

public void SetSource(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

FileInfo که به عنوان جریان ورودی باز خواهد شد.

مثال‌ها

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

استثناها

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

مسیر فایل خالی است یا فقط شامل فضاهای خالی است.

FileNotFoundException

فایل یافت نشد.

مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.

DirectoryNotFoundException

fileInfo تهی است.

مسیر مشخص‌شده نامعتبر است، مانند اینکه در یک درایو نام‌گذاری نشده است.

فایل قبلاً باز شده است.

SetSource(string)

محتویات را برای فشرده‌سازی درون آرشیو تنظیم می‌کند.

public void SetSource(string sourcePath)

پارامترها

sourcePath string

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

مثال‌ها

using (var archive = new ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

استثناها

sourcePath تهی است یا رشته خالی است.

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

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

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

sourcePath، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.