Class LzmaArchive
Namespace: Aspose.Zip.LZMA
Assembly: Aspose.Zip.dll (25.1.0)
این کلاس نمایانگر فایل آرشیو LZMA است. از آن برای ترکیب یا استخراج آرشیوهای LZMA استفاده کنید.
public class LzmaArchive : IArchive, IDisposable, IArchiveFileEntry
وراثت
پیادهسازیها
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) مراجعه کنید.
استثناها
source
قابل جستجو نیست.
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) مراجعه کنید.
استثناها
path
تهی است.
فراخوانی کننده مجوز لازم برای دسترسی را ندارد.
path
خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path
ممنوع است.
path
مشخص شده، نام فایل، یا هر دو از حداکثر طول تعریف شده توسط سیستم فراتر میروند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فایل در 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);
}
}
}
استثناها
سرفصلهای آرشیو و اطلاعات خدمات خوانده نشدهاند.
آرشیو خراب است.
جریان مقصد تهی است.
جریان مقصد از نوشتن پشتیبانی نمیکند.
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"));
}
}
استثناها
سرفصلهای آرشیو و اطلاعات خدمات خوانده نشدهاند.
فراخوانی کننده مجوز لازم برای باز کردن fileInfo
را ندارد.
مسیر فایل خالی است یا فقط شامل فضاهای خالی است.
فایل پیدا نشد.
مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.
fileInfo
تهی است.
مسیر مشخص شده نامعتبر است، مانند اینکه در یک درایو نامشخص باشد.
فایل در حال حاضر باز است.
آرشیو خراب است.
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");
}
}
استثناها
سرفصلهای آرشیو و اطلاعات خدمات خوانده نشدهاند.
path
تهی است.
فراخوانی کننده مجوز لازم برای دسترسی را ندارد.
path
خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path
ممنوع است.
path
مشخص شده، نام فایل، یا هر دو از حداکثر طول تعریف شده توسط سیستم فراتر میروند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فایل در path
شامل یک دو نقطه (:) در وسط رشته است.
آرشیو خراب است.
ExtractToDirectory(string)
محتویات آرشیو را به دایرکتوری ارائه شده استخراج میکند.
public void ExtractToDirectory(string destinationDirectory)
پارامترها
destinationDirectory
string
مسیر به دایرکتوری که فایلهای استخراج شده در آن قرار میگیرند.
توضیحات
اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.
استثناها
destinationDirectory
تهی است.
path
مشخص شده، نام فایل، یا هر دو از حداکثر طول تعریف شده توسط سیستم فراتر میروند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فراخوانی کننده مجوز لازم برای دسترسی به دایرکتوری موجود را ندارد.
اگر دایرکتوری وجود نداشته باشد، مسیر شامل یک کاراکتر دو نقطه (:) باشد که بخشی از برچسب درایو (“C:") نیست.
destinationDirectory
یک رشته با طول صفر است، فقط شامل فضاهای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است. میتوانید با استفاده از متد System.IO.Path.GetInvalidPathChars کاراکترهای نامعتبر را جستجو کنید.
-یا- مسیر با یک کاراکتر دو نقطه (:) پیشوند شده یا فقط شامل آن باشد.
دایرکتوری مشخص شده توسط مسیر یک فایل است. -یا- نام شبکه شناخته شده نیست.
آرشیو خراب است.
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
باید قابل جستجو باشد.
استثناها
output
از جستجو پشتیبانی نمیکند.
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"));
}
استثناها
فراخوانی کننده مجوز لازم برای باز کردن destination
را ندارد.
مسیر فایل خالی است یا فقط شامل فضاهای خالی است.
فایل پیدا نشد.
مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.
destination
تهی است.
مسیر مشخص شده نامعتبر است، مانند اینکه در یک درایو نامشخص باشد.
فایل در حال حاضر باز است.
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");
}
استثناها
destinationFileName
تهی است.
فراخوانی کننده مجوز لازم برای دسترسی را ندارد.
destinationFileName
خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل destinationFileName
ممنوع است.
destinationFileName
مشخص شده، نام فایل، یا هر دو از حداکثر طول تعریف شده توسط سیستم فراتر میروند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فایل در 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");
}
استثناها
جریان 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");
}
استثناها
فراخوانی کننده مجوز لازم برای باز کردن fileInfo
را ندارد.
مسیر فایل خالی است یا فقط شامل فضاهای خالی است.
فایل پیدا نشد.
مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.
fileInfo
تهی است.
مسیر مشخص شده نامعتبر است، مانند اینکه در یک درایو نامشخص باشد.
فایل در حال حاضر باز است.
SetSource(string)
محتوا را برای فشردهسازی درون آرشیو تنظیم میکند.
public void SetSource(string sourcePath)
پارامترها
sourcePath
string
مسیر به فایلی که به عنوان جریان ورودی باز خواهد شد.
مثالها
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lzma");
}
استثناها
sourcePath
تهی است.
فراخوانی کننده مجوز لازم برای دسترسی را ندارد.
sourcePath
خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل sourcePath
ممنوع است.
sourcePath
مشخص شده، نام فایل، یا هر دو از حداکثر طول تعریف شده توسط سیستم فراتر میروند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فایل در sourcePath
شامل یک دو نقطه (:) در وسط رشته است.