Class LzipArchive

Class LzipArchive

Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)

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

public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry

وراثت

objectLzipArchive

پیاده‌سازی‌ها

IArchive, IDisposable, IArchiveFileEntry

اعضای ارث‌بری شده

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

سازنده‌ها

LzipArchive(LzipArchiveSettings)

یک نمونه جدید از Aspose.Zip.Lzip.LzipArchive را راه‌اندازی می‌کند.

public LzipArchive(LzipArchiveSettings settings = null)

پارامترها

settings LzipArchiveSettings

تنظیمات آرشیو lzip خاص با تعریف اندازه دیکشنری.

LzipArchive(Stream)

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

public LzipArchive(Stream sourceStream)

پارامترها

sourceStream Stream

منبع آرشیو.

توضیحات

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

استثناها

ArgumentException

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

ArgumentNullException

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) مراجعه کنید.

استثناها

ArgumentNullException

path نال است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

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);
        }
   }
}

استثناها

InvalidOperationException

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

InvalidDataException

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

ArgumentNullException

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

ArgumentException

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

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"));
    }
}

استثناها

InvalidOperationException

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

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo نال است.

DirectoryNotFoundException

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

IOException

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

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");
    }
}

استثناها

InvalidOperationException

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

ArgumentNullException

path نال است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

پارامترها

destinationDirectory string

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

توضیحات

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

استثناها

ArgumentNullException

destinationDirectory نال است.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

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 باید قابل جستجو باشد.

استثناها

ArgumentException

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

ArgumentNullException

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");
}

استثناها

ArgumentNullException

destinationFileName نال است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در 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"));
}

استثناها

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination نال است.

DirectoryNotFoundException

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

IOException

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

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");
}

استثناها

ArgumentException

جریان 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");
}

استثناها

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo نال است.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string path)

پارامترها

path string

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

مثال‌ها

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

استثناها

ArgumentNullException

path نال است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 فارسی