Class LzipArchive

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

sourceStream نال است.

InvalidDataException

هدرها با نوع آرشیو lzip مطابقت ندارند.

LzipArchive(string)

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

public LzipArchive(string path)

پارامترها

path string

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

مثال‌ها

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

توضیحات

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

استثناها

path نال است.

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

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

دسترسی به فایل path ممنوع است.

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

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

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

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

InvalidOperationException

فایل قبلاً باز است.

InvalidDataException

هدرها با نوع آرشیو lzip مطابقت ندارند.

ویژگی‌ها

Settings

تنظیمات آرشیو lzip خاص را دریافت می‌کند.

public LzipArchiveSettings Settings { get; }

مقدار ویژگی

LzipArchiveSettings

متدها

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

پارامترها

disposing bool

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

Extract(Stream)

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

public void Extract(Stream destination)

پارامترها

destination Stream

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

مثال‌ها

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

استثناها

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

InvalidDataException

خطا در داده‌ها در هدر یا checksum.

جریان مقصد نال است.

InvalidOperationException

جریان مقصد از نوشتن پشتیبانی نمی‌کند.

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

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

مثال‌ها

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

استثناها

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

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

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

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

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

fileInfo نال است.

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

InvalidOperationException

فایل قبلاً باز است.

Extract(string)

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

public void Extract(string path)

پارامترها

path string

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

مثال‌ها

using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzipArchive(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)

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

public void Save(Stream outputStream)

پارامترها

outputStream Stream

جریان مقصد.

مثال‌ها

using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
    using (var archive = new LzipArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzFile);
     }
}

توضیحات

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

استثناها

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

outputStream نال است.

Save(string)

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

public void Save(string destinationFileName)

پارامترها

destinationFileName string

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

مثال‌ها

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

استثناها

destinationFileName نال است.

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

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

دسترسی به فایل destinationFileName ممنوع است.

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

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

Save(FileInfo)

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

public void Save(FileInfo destination)

پارامترها

destination FileInfo

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

مثال‌ها

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

استثناها

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

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

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

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

destination نال است.

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

فایل قبلاً باز است.

SetSource(Stream)

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

public void SetSource(Stream source)

پارامترها

source Stream

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

مثال‌ها

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

استثناها

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

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

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

مثال‌ها

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

استثناها

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

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

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

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

fileInfo نال است.

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

فایل قبلاً باز است.

SetSource(string)

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

public void SetSource(string path)

پارامترها

path string

مسیر به فایلی که باید فشرده شود.

مثال‌ها

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

استثناها

path نال است.

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

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

دسترسی به فایل path ممنوع است.