Class ZArchive
نام ها : Aspose.Zip.Z جمع آوری: Aspose.Zip.dll (25.5.0)
این کلاس یک فایل آرشیو Z (کمپرس) را نشان می دهد.استفاده از آن برای ترکیب یا استخراج فایل های Z.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
اعضای ارثی
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
مشاهده https://docs.fileformat.com/compression/z/
Constructors
آرشیو()
یک مثال جدید از کلاس Aspose.Zip.Z.Archive آماده برای فشرده سازی آغاز می شود.
public ZArchive()آرشیو(بایگانی برچسب ها: ZArchiveLoadOptions)
شروع یک مثال جدید از کلاس Aspose.Zip.Z.Archive آماده برای انقباض.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)Parameters
source Stream
منبع این آرشیو
loadOptions ZArchiveLoadOptions
گزینه هایی برای بارگذاری آرشیو
Remarks
این سازنده از بین نمی رود. مشاهده Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) روش برای از بین بردن.
Exceptions
source’ is not seekable.
source’ is null.
آرشیو(بایگانی برچسب ها: ZArchiveLoadOptions)
شروع یک مثال جدید از کلاس Aspose.Zip.Z.Archive آماده برای انقباض.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)Parameters
path string
راه رسیدن به منبع آرشیو
loadOptions ZArchiveLoadOptions
گزینه هایی برای بارگذاری آرشیو
Remarks
این سازنده از بین نمی رود. مشاهده Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) روش برای از بین بردن.
Exceptions
path’ is null.
متقاضی مجوز لازم برای دسترسی ندارد.
مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.
دسترسی به فایل path" رد می شود.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
فایل در path" حاوی یک ستون (:) در وسط ردیف است.
این فایل یافت نشد.
مسیر مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه.
فایل در حال حاضر باز است.
Methods
Dispose()
انجام وظایف تعیین شده در برنامه مرتبط با آزاد کردن، آزاد کردن و یا بازگرداندن منابع غیر مدیریت شده.
public void Dispose()Dispose(بول)
انجام وظایف تعیین شده در برنامه مرتبط با آزاد کردن، آزاد کردن و یا بازگرداندن منابع غیر مدیریت شده.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
آیا منابع مدیریت شده باید از بین برود؟
Extract(Stream)
فایل Z را به یک جریان اضافه کنید.
public void Extract(Stream destination)Parameters
destination Stream
جریان برای ذخیره سازی داده های فشرده
Examples
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);
}
}
}Exceptions
داده ها نمی توانند فشرده شوند.
Extract(FileInfo)
فایل Z را به یک فایل اضافه کنید.
public void Extract(FileInfo fileInfo)Parameters
fileInfo FileInfo
FileInfo برای ذخیره سازی داده های فشرده
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}Exceptions
تماس گیرنده اجازه لازم برای باز کردن fileInfo را ندارد.
مسیر فایل خالی است یا فقط حاوی فضاهای سفید است.
این فایل یافت نشد.
مسیر به فایل فقط خوانده شده است یا یک دایرکتوری است.
fileInfo’ is null.
مسیر مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه.
فایل در حال حاضر باز است.
داده ها نمی توانند فشرده شوند.
Extract(String)
استخراج آرشیو Z به یک فایل در مسیر.
public FileInfo Extract(string path)Parameters
path string
مسیر به فایل که داده های فشرده را ذخیره می کند.
Returns
اطلاعات مربوط به یک فایل استخراج شده
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}Exceptions
path’ is null.
متقاضی مجوز لازم برای دسترسی ندارد.
مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.
دسترسی به فایل path" رد می شود.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
فایل در path" حاوی یک ستون (:) در وسط ردیف است.
داده ها نمی توانند فشرده شوند.
ExtractToDirectory(String)
محتوای آرشیو را به دایرکتوری ارائه شده استخراج کنید.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
مسیر به دایرکتوری برای قرار دادن فایل های استخراج شده در.
Remarks
اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.
Exceptions
destinationDirectory’ is null.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
تماس گیرنده اجازه لازم برای دسترسی به دایرکتوری موجود را ندارد.
اگر دایرکتوری وجود ندارد، مسیر حاوی یک کاراکتر ستون فقرات (:) است که بخشی از یک برچسب درایو نیست (“C:”).
destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).
دایرکتوری مشخص شده توسط مسیر یک فایل است. -یا- نام شبکه شناخته نشده است.
Save(بایگانی برچسب ها: ZArchiveSaveOptions)
ذخیره xz آرشیو به جریان ارائه شده.
public void Save(Stream output, ZArchiveSaveOptions settings = null)Parameters
output Stream
جریان مقصد
settings ZArchiveSaveOptions
تنظیمات اختیاری برای ترکیب آرشیو
Examples
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}Remarks
باید قابل جستجو باشد.
Exceptions
output’ does not support seeking.
output’ is null.
Save(بایگانی برچسب ها: ZArchiveSaveOptions)
ذخیره آرشیو Z به فایل مقصد ارائه شده است.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)Parameters
destinationFileName string
اگر نام فایل مشخص شده به یک فایل موجود اشاره کند، آن را بیش از حد نوشته خواهد شد.
settings ZArchiveSaveOptions
تنظیمات اختیاری برای ترکیب آرشیو
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Exceptions
destinationFileName’ is null.
متقاضی مجوز لازم برای دسترسی ندارد.
کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه
دسترسی به فایل destinationFileName’ رد می شود.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
فایل در destinationFileName’ حاوی یک ستون (:) در وسط ردیف است.
SetSource(Stream)
قرار دادن محتوا برای فشرده سازی در داخل آرشیو
public void SetSource(Stream source)Parameters
source Stream
جریان ورودی برای آرشیو
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}SetSource(FileInfo)
قرار دادن محتوا برای فشرده سازی در داخل آرشیو
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
FileInfo که به عنوان جریان ورودی باز می شود.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Exceptions
تماس گیرنده اجازه لازم برای باز کردن fileInfo را ندارد.
مسیر فایل خالی است یا فقط حاوی فضاهای سفید است.
این فایل یافت نشد.
مسیر به فایل فقط خوانده شده است یا یک دایرکتوری است.
fileInfo’ is null.
مسیر مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه.
فایل در حال حاضر باز است.
SetSource(String)
قرار دادن محتوا برای فشرده سازی در داخل آرشیو
public void SetSource(string sourcePath)Parameters
sourcePath string
مسیر به فایل که به عنوان جریان ورودی باز خواهد شد.
Examples
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}Exceptions
sourcePath’ is null or empty string.
تماس گیرنده اجازه لازم برای دسترسی به یک منبع را ندارد.
sourcePath خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.
دسترسی به فایل sourcePath" رد می شود.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
فایل در sourcePath" حاوی یک ستون (:) در وسط نوار است.
