Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
این کلاس نمایانگر فایل آرشیو Z (فشردهسازی) است. از آن برای ترکیب یا استخراج آرشیوهای Z استفاده کنید.
public class ZArchive : 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()
شرح
به https://docs.fileformat.com/compression/z/ مراجعه کنید.
سازندهها
ZArchive()
یک نمونه جدید از کلاس Aspose.Zip.Z.ZArchive را برای فشردهسازی آماده میکند.
public ZArchive()
ZArchive(Stream, ZArchiveLoadOptions)
یک نمونه جدید از کلاس Aspose.Zip.Z.ZArchive را برای استخراج آماده میکند.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)
پارامترها
source
Stream
منبع آرشیو.
loadOptions
ZArchiveLoadOptions
گزینهها برای بارگذاری آرشیو.
توضیحات
این سازنده فشردهسازی نمیکند. برای فشردهسازی به متد Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) مراجعه کنید.
استثناها
source
قابل جستجو نیست.
source
تهی است.
ZArchive(string, ZArchiveLoadOptions)
یک نمونه جدید از کلاس Aspose.Zip.Z.ZArchive را برای استخراج آماده میکند.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)
پارامترها
path
string
مسیر به منبع آرشیو.
loadOptions
ZArchiveLoadOptions
گزینهها برای بارگذاری آرشیو.
توضیحات
این سازنده فشردهسازی نمیکند. برای فشردهسازی به متد Aspose.Zip.Z.ZArchive.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)
آرشیو Z را به یک جریان استخراج میکند.
public void Extract(Stream destination)
پارامترها
destination
Stream
جریان برای ذخیرهسازی دادههای فشردهنشده.
مثالها
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(extractedFile);
}
}
}
استثناها
دادهها نمیتوانند فشردهسازی شوند.
Extract(FileInfo)
آرشیو Z را به یک فایل استخراج میکند.
public void Extract(FileInfo fileInfo)
پارامترها
fileInfo
FileInfo
FileInfo برای ذخیرهسازی دادههای فشردهنشده.
مثالها
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
استثناها
فراخوانیکننده مجوز لازم برای باز کردن fileInfo
را ندارد.
مسیر فایل خالی است یا فقط شامل فضاهای خالی است.
فایل یافت نشد.
مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.
fileInfo
تهی است.
مسیر مشخصشده نامعتبر است، مانند اینکه در یک درایو نامگذاری نشده است.
فایل قبلاً باز شده است.
دادهها نمیتوانند فشردهسازی شوند.
Extract(string)
آرشیو Z را به یک فایل با مسیر استخراج میکند.
public FileInfo Extract(string path)
پارامترها
path
string
مسیر به فایلی که دادههای فشردهنشده را ذخیره میکند.
بازگشت
اطلاعات فایل استخراجشده.
مثالها
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
استثناها
path
تهی است.
فراخوانیکننده مجوز لازم برای دسترسی را ندارد.
path
خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path
رد شده است.
path
، نام فایل، یا هر دو از حداکثر طول تعریفشده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشد.
فایل در path
شامل یک دو نقطه (:) در وسط رشته است.
دادهها نمیتوانند فشردهسازی شوند.
ExtractToDirectory(string)
محتویات آرشیو را به دایرکتوری مشخصشده استخراج میکند.
public void ExtractToDirectory(string destinationDirectory)
پارامترها
destinationDirectory
string
مسیر به دایرکتوری برای قرار دادن فایلهای استخراجشده.
توضیحات
اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.
استثناها
destinationDirectory
تهی است.
destinationDirectory
، نام فایل، یا هر دو از حداکثر طول تعریفشده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشد.
فراخوانیکننده مجوز لازم برای دسترسی به دایرکتوری موجود را ندارد.
اگر دایرکتوری وجود نداشته باشد، مسیر شامل یک کاراکتر دو نقطه (:) است که بخشی از برچسب درایو نیست (“C:") .
destinationDirectory
یک رشته با طول صفر است، فقط شامل فضاهای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است. میتوانید با استفاده از متد System.IO.Path.GetInvalidPathChars کاراکترهای نامعتبر را جستجو کنید.
- یا - مسیر با یک کاراکتر دو نقطه (:) پیشوند یا فقط شامل آن است.
دایرکتوری مشخصشده توسط مسیر یک فایل است. - یا - نام شبکه ناشناخته است.
Save(Stream, ZArchiveSaveOptions)
آرشیو xz را به جریان ارائهشده ذخیره میکند.
public void Save(Stream output, ZArchiveSaveOptions settings = null)
پارامترها
output
Stream
جریان مقصد.
settings
ZArchiveSaveOptions
تنظیمات اختیاری برای ترکیب آرشیو.
مثالها
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}
توضیحات
output
باید قابل جستجو باشد.
استثناها
output
از جستجو پشتیبانی نمیکند.
output
تهی است.
Save(string, ZArchiveSaveOptions)
آرشیو Z را به فایل مقصد ارائهشده ذخیره میکند.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)
پارامترها
destinationFileName
string
+مسیر آرشیو که باید ایجاد شود. اگر نام فایل مشخصشده به یک فایل موجود اشاره کند، آن فایل بازنویسی خواهد شد.
settings
ZArchiveSaveOptions
تنظیمات اختیاری برای ترکیب آرشیو.
مثالها
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
استثناها
destinationFileName
تهی است.
فراخوانیکننده مجوز لازم برای دسترسی را ندارد.
destinationFileName
خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل destinationFileName
رد شده است.
destinationFileName
، نام فایل، یا هر دو از حداکثر طول تعریفشده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشد.
فایل در destinationFileName
شامل یک دو نقطه (:) در وسط رشته است.
SetSource(Stream)
محتویات را برای فشردهسازی درون آرشیو تنظیم میکند.
public void SetSource(Stream source)
پارامترها
source
Stream
جریان ورودی برای آرشیو.
مثالها
using (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}
SetSource(FileInfo)
محتویات را برای فشردهسازی درون آرشیو تنظیم میکند.
public void SetSource(FileInfo fileInfo)
پارامترها
fileInfo
FileInfo
FileInfo که به عنوان جریان ورودی باز خواهد شد.
مثالها
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
استثناها
فراخوانیکننده مجوز لازم برای باز کردن fileInfo
را ندارد.
مسیر فایل خالی است یا فقط شامل فضاهای خالی است.
فایل یافت نشد.
مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.
fileInfo
تهی است.
مسیر مشخصشده نامعتبر است، مانند اینکه در یک درایو نامگذاری نشده است.
فایل قبلاً باز شده است.
SetSource(string)
محتویات را برای فشردهسازی درون آرشیو تنظیم میکند.
public void SetSource(string sourcePath)
پارامترها
sourcePath
string
مسیر به فایلی که به عنوان جریان ورودی باز خواهد شد.
مثالها
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}
استثناها
sourcePath
تهی است یا رشته خالی است.
فراخوانیکننده مجوز لازم برای دسترسی به یک منبع را ندارد.
sourcePath
خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل sourcePath
رد شده است.
sourcePath
، نام فایل، یا هر دو از حداکثر طول تعریفشده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشد.
فایل در sourcePath
شامل یک دو نقطه (:) در وسط رشته است.