Class LzmaArchive

Class LzmaArchive

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

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

public class LzmaArchive : IArchive, IDisposable, IArchiveFileEntry

وراثت

objectLzmaArchive

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

IArchive, IDisposable, IArchiveFileEntry

اعضای وراثت‌یافته

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

سازنده‌ها

LzmaArchive(LzmaArchiveSettings)

یک نمونه جدید از کلاس Aspose.Zip.LZMA.LzmaArchive را ایجاد کرده و آرشیو را در فرمت lzma ترکیب می‌کند.

public LzmaArchive(LzmaArchiveSettings settings = null)

پارامترها

settings LzmaArchiveSettings

مجموعه‌ای از تنظیمات خاص آرشیو lzma.

LzmaArchive(Stream)

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

public LzmaArchive(Stream source)

پارامترها

source Stream

منبع آرشیو.

توضیحات

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

استثناها

ArgumentException

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

ArgumentNullException

source تهی است.

LzmaArchive(string)

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

public LzmaArchive(string path)

پارامترها

path string

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

مثال‌ها

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

توضیحات

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

استثناها

ArgumentNullException

path تهی است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

متدها

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

پارامترها

disposing bool

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

Extract(Stream)

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

public void Extract(Stream destination)

پارامترها

destination Stream

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

مثال‌ها

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

استثناها

InvalidOperationException

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

InvalidDataException

آرشیو خراب است.

ArgumentNullException

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

ArgumentException

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

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

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

مثال‌ها

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

استثناها

InvalidOperationException

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

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo تهی است.

DirectoryNotFoundException

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

IOException

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

InvalidDataException

آرشیو خراب است.

Extract(string)

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

public void Extract(string path)

پارامترها

path string

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

مثال‌ها

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

استثناها

InvalidOperationException

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

ArgumentNullException

path تهی است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

InvalidDataException

آرشیو خراب است.

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

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

InvalidDataException

آرشیو خراب است.

Save(Stream)

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

public void Save(Stream output)

پارامترها

output Stream

جریان مقصد.

مثال‌ها

using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
    using (var archive = new LzmaArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzmaFile);
     }
}

توضیحات

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

استثناها

ArgumentException

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

ArgumentNullException

output تهی است.

Save(FileInfo)

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

public void Save(FileInfo destination)

پارامترها

destination FileInfo

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

مثال‌ها

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

استثناها

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination تهی است.

DirectoryNotFoundException

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

IOException

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

Save(string)

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

public void Save(string destinationFileName)

پارامترها

destinationFileName string

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

مثال‌ها

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

استثناها

ArgumentNullException

destinationFileName تهی است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

SetSource(Stream)

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

public void SetSource(Stream source)

پارامترها

source Stream

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

مثال‌ها

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

استثناها

ArgumentException

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

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

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

مثال‌ها

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

استثناها

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo تهی است.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string sourcePath)

پارامترها

sourcePath string

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

مثال‌ها

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

استثناها

ArgumentNullException

sourcePath تهی است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 فارسی