Class LzipArchive
Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)
این کلاس نمایانگر فایل آرشیو Lzip است. از آن برای ترکیب یا استخراج آرشیوهای Lzip استفاده کنید.
public class LzipArchive : 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()
سازندهها
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) مراجعه کنید.
استثناها
sourceStream
قابل جستجو نیست.
sourceStream
نال است.
هدرها با نوع آرشیو 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
شامل دو نقطه (:) در وسط رشته است.
فایل پیدا نشد.
مسیر مشخص شده نامعتبر است، مانند اینکه در درایو نقشهبرداری نشده باشد.
فایل قبلاً باز است.
هدرها با نوع آرشیو lzip مطابقت ندارند.
ویژگیها
Settings
تنظیمات آرشیو lzip خاص را دریافت میکند.
public LzipArchiveSettings Settings { get; }
مقدار ویژگی
متدها
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);
}
}
}
استثناها
هدرهای آرشیو و اطلاعات خدمات خوانده نشدهاند.
خطا در دادهها در هدر یا checksum.
جریان مقصد نال است.
جریان مقصد از نوشتن پشتیبانی نمیکند.
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
نال است.
مسیر مشخص شده نامعتبر است، مانند اینکه در درایو نقشهبرداری نشده باشد.
فایل قبلاً باز است.
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
، نام فایل، یا هر دو از حداکثر طول تعریف شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فایل در path
شامل دو نقطه (:) در وسط رشته است.
ExtractToDirectory(string)
محتویات آرشیو را به دایرکتوری ارائه شده استخراج میکند.
public void ExtractToDirectory(string destinationDirectory)
پارامترها
destinationDirectory
string
مسیر به دایرکتوری که فایلهای استخراج شده در آن قرار خواهند گرفت.
توضیحات
اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.
استثناها
destinationDirectory
نال است.
path
، نام فایل، یا هر دو از حداکثر طول تعریف شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فراخوانیکننده مجوز لازم برای دسترسی به دایرکتوری موجود را ندارد.
اگر دایرکتوری وجود نداشته باشد، مسیر شامل کاراکتر دو نقطه (:) است که بخشی از برچسب درایو نیست (“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
ممنوع است.
path
، نام فایل، یا هر دو از حداکثر طول تعریف شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فایل در path
شامل دو نقطه (:) در وسط رشته است.