Class XzArchive

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

source تهی است.

XzArchive(string)

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

public XzArchive(string path)

پارامترها

path string

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

توضیحات

این سازنده استخراج نمی‌کند. برای استخراج، به متد Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) مراجعه کنید.

استثناها

path تهی است.

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

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

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

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

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

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

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

InvalidOperationException

فایل در حال حاضر باز است.

متدها

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

پارامترها

disposing bool

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

Extract(Stream)

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

public void Extract(Stream destination)

پارامترها

destination Stream

استریم برای ذخیره داده‌های استخراج‌شده.

مثال‌ها

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

استثناها

هدرهای آرشیو و اطلاعات خدمات خوانده نشدند.

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

FileInfo برای ذخیره داده‌های استخراج‌شده.

مثال‌ها

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

استثناها

InvalidOperationException

هدرهای آرشیو و اطلاعات خدمات خوانده نشدند.

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

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

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

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

fileInfo تهی است.

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

InvalidOperationException

فایل در حال حاضر باز است.

Extract(string)

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

public FileInfo Extract(string path)

پارامترها

path string

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

بازگشت

FileInfo

نمونه System.IO.FileInfo شامل داده‌های استخراج‌شده.

مثال‌ها

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

استثناها

هدرهای آرشیو و اطلاعات خدمات خوانده نشدند.

path تهی است.

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

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

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

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

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

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

فایل در حال حاضر باز است.

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

پارامترها

destinationDirectory string

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

توضیحات

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

استثناها

destinationDirectory تهی است.

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

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

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

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

Save(Stream)

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

public void Save(Stream output)

پارامترها

output Stream

استریم مقصد.

مثال‌ها

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

توضیحات

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

استثناها

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

output تهی است.

Save(string)

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

public void Save(string destinationFileName)

پارامترها

destinationFileName string

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

مثال‌ها

using (var archive = new XzArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.xz");
}

استثناها

destinationFileName تهی است.

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

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

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

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

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

SetSource(Stream)

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

public void SetSource(Stream source)

پارامترها

source Stream

استریم ورودی برای آرشیو.

مثال‌ها

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

استثناها

استریم source غیرقابل جستجو است.

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

FileInfo که به عنوان استریم ورودی باز خواهد شد.

مثال‌ها

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

استثناها

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

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

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

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

fileInfo تهی است.

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

فایل در حال حاضر باز است.

SetSource(string)

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

public void SetSource(string sourcePath)

پارامترها

sourcePath string

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

مثال‌ها

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

استثناها

sourcePath تهی است.

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

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

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

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