Class XzArchive
نام ها : Aspose.Zip.Xz جمع آوری: Aspose.Zip.dll (25.5.0)
این کلاس فایل آرشیو xz را نشان می دهد. از آن برای ترکیب و استخراج فایل های xz استفاده کنید.
public class XzArchive : 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()
Constructors
XzArchive(XzArchiveSettings)
یک مثال جدید از کلاس Aspose.Zip.Xz.XzArchive را آغاز می کند و آرشیو را در فرمت xz تشکیل می دهد.
public XzArchive(XzArchiveSettings settings = null)Parameters
settings XzArchiveSettings
مجموعه تنظیمات خاص xz آرشیو: اندازه دیکشنری، اندازه بلوک، نوع چک.
XzArchive(Stream)
شروع یک مثال جدید از کلاس Aspose.Zip.Xz.XzArchive آماده برای انقباض.
public XzArchive(Stream source)Parameters
source Stream
منبع این آرشیو
Remarks
این سازنده از بین نمی رود. مشاهده Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) روش برای از بین بردن.
Exceptions
source’ is not seekable.
source’ is null.
XzArchive(String)
شروع یک مثال جدید از کلاس Aspose.Zip.Xz.XzArchive آماده برای انقباض.
public XzArchive(string path)Parameters
path string
راه رسیدن به منبع آرشیو
Remarks
این سازنده از بین نمی رود. مشاهده Aspose.Zip.Xz.XzArchive.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)
فایل xz را به یک جریان اضافه کنید.
public void Extract(Stream destination)Parameters
destination Stream
جریان برای ذخیره سازی داده های فشرده
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(extractedFile);
}
}
}Exceptions
عنوان های آرشیو و اطلاعات خدمات خوانده نشده است.
Extract(FileInfo)
فایل xz را به یک فایل اضافه کنید.
public void Extract(FileInfo fileInfo)Parameters
fileInfo FileInfo
FileInfo برای ذخیره سازی داده های فشرده
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}Exceptions
عنوان های آرشیو و اطلاعات خدمات خوانده نشده است.
تماس گیرنده اجازه لازم برای باز کردن fileInfo را ندارد.
مسیر فایل خالی است یا فقط حاوی فضاهای سفید است.
این فایل یافت نشد.
مسیر به فایل فقط خوانده شده است یا یک دایرکتوری است.
fileInfo’ is null.
مسیر مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه.
فایل در حال حاضر باز است.
Extract(String)
xz آرشیو را به یک فایل با مسیر استخراج کنید.
public FileInfo Extract(string path)Parameters
path string
مسیر به فایل که داده های فشرده را ذخیره می کند.
Returns
سیستم.IO.FileInfo مثال حاوی داده های استخراج شده است.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
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(Stream)
ذخیره xz آرشیو به جریان ارائه شده.
public void Save(Stream output)Parameters
output Stream
جریان مقصد
Examples
using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save(xzFile);
}
}Remarks
باید قابل جستجو باشد.
Exceptions
output’ does not support seeking.
output’ is null.
Save(String)
ذخیره فایل xz به فایل مقصد ارائه شده است.
public void Save(string destinationFileName)Parameters
destinationFileName string
اگر نام فایل مشخص شده به یک فایل موجود اشاره کند، آن را بیش از حد نوشته خواهد شد.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.xz");
}Exceptions
destinationFileName’ is null.
متقاضی مجوز لازم برای دسترسی ندارد.
کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه
دسترسی به فایل destinationFileName’ رد می شود.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
فایل در destinationFileName’ حاوی یک ستون (:) در وسط ردیف است.
SetSource(Stream)
قرار دادن محتوا برای فشرده سازی در داخل آرشیو
public void SetSource(Stream source)Parameters
source Stream
جریان ورودی برای آرشیو
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}Exceptions
جریان منبع غیر قابل جستجو است.
SetSource(FileInfo)
قرار دادن محتوا برای فشرده سازی در داخل آرشیو
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
FileInfo، که به عنوان جریان ورودی باز خواهد شد.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.xz");
}Exceptions
تماس گیرنده اجازه لازم برای باز کردن fileInfo را ندارد.
مسیر فایل خالی است یا فقط حاوی فضاهای سفید است.
این فایل یافت نشد.
مسیر به فایل فقط خوانده شده است یا یک دایرکتوری است.
fileInfo’ is null.
مسیر مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه.
فایل در حال حاضر باز است.
SetSource(String)
قرار دادن محتوا برای فشرده سازی در داخل آرشیو
public void SetSource(string sourcePath)Parameters
sourcePath string
مسیر به فایل که به عنوان جریان ورودی باز خواهد شد.
Examples
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}Exceptions
sourcePath’ is null.
متقاضی مجوز لازم برای دسترسی ندارد.
sourcePath خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.
دسترسی به فایل sourcePath" رد می شود.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
فایل در sourcePath" حاوی یک ستون (:) در وسط نوار است.
