Class XarArchive

Class XarArchive

نام ها : Aspose.Zip.Xar جمع آوری: Aspose.Zip.dll (25.5.0)

این کلاس یک فایل آرشیو xar را نشان می دهد.

public class XarArchive : IArchive, IDisposable

Inheritance

object ← XarArchive

Implements

IArchive , IDisposable

اعضای ارثی

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

XarArchive(XarCompressionSettings)

شروع یک مثال جدید از کلاس Aspose.Zip.Xar.XarArchive.

public XarArchive(XarCompressionSettings defaultCompressionSettings = null)

Parameters

defaultCompressionSettings XarCompressionSettings

تنظیمات فشرده سازی پیش فرض، برای تمام ورودی های آرشیو اعمال می شود.

Examples

مثال زیر نشان می دهد که چگونه یک فایل را فشرده کنید.

using (var archive = new XarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.xar");
}

XarArchive(بایگانی برچسب ها: XarLoadOptions)

یک مثال جدید از کلاس Aspose.Zip.Xar.xarArchive را آغاز می کند و یک لیست ورودی را می سازد که می تواند از آرشیو استخراج شود.

public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)

Parameters

sourceStream Stream

بایگانی برچسب ها: باید جستجو شود

loadOptions XarLoadOptions

گزینه هایی برای بارگذاری آرشیو

Examples

مثال زیر نشان می دهد که چگونه تمام ورودی ها را به یک دایرکتوری استخراج کنیم.

using (var archive = new XarArchive(File.OpenRead("archive.xar")))
{
   archive.ExtractToDirectory("C:\\extracted");
}

Remarks

این سازنده هیچ ورودی را حذف نمی کند. مشاهده Aspose.Zip.Xar.XarFileEntry.Open روش برای حذف بسته بندی.

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

XarArchive(برچسب ها: XarLoadOptions)

یک مثال جدید از کلاس Aspose.Zip.Xar.xarArchive را آغاز می کند و یک لیست ورودی را می سازد که می تواند از آرشیو استخراج شود.

public XarArchive(string path, XarLoadOptions loadOptions = null)

Parameters

path string

راه رفتن به فایل آرشیو

loadOptions XarLoadOptions

گزینه هایی برای بارگذاری آرشیو

Examples

مثال زیر نشان می دهد که چگونه تمام ورودی ها را به یک دایرکتوری استخراج کنیم.

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

Remarks

این سازنده هیچ ورودی را حذف نمی کند. مشاهده Aspose.Zip.Xar.XarFileEntry.Open روش برای حذف بسته بندی.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

متقاضی مجوز لازم برای دسترسی ندارد.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

دسترسی به فایل path" رد می شود.

PathTooLongException

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در path" حاوی یک ستون (:) در وسط ردیف است.

FileNotFoundException

این فایل یافت نشد.

DirectoryNotFoundException

مسیر مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه.

IOException

فایل در حال حاضر باز است.

InvalidDataException

فایل در path" یک آرشیو xar معتبر نیست.

Properties

Entries

دریافت ورودی از Aspose.Zip.Xar.XarEntry نوع تشکیل آرشیو.

public IEnumerable<xarentry> Entries { get; }

ارزش املاک

IEnumerable &lt؛ XarEntry >

Methods

CreateEntries(بایگانی برچسب ها: XarCompressionSettings)

اضافه کردن به آرشیو تمام فایل ها و دایرکتوری ها به طور تکراری در دایرکتوری داده شده.

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

Parameters

sourceDirectory string

دستورالعمل برای فشرده سازی

includeRootDirectory bool

نشان می دهد که آیا باید خود دایرکتوری ریشه را شامل شود یا نه.

compressionSettings XarCompressionSettings

تنظیمات فشرده سازی برای اضافه کردن عناصر Aspose.Zip.Xar.XarEntry استفاده می شود.

Returns

XarArchive

محدوده ورودی

Examples 

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(@"C:\folder", false);
        archive.Save(xarFile);
    }
}

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

تماس گیرنده اجازه لازم برای دسترسی به sourceDirectory را ندارد.

ArgumentException

sourceDirectory’ contains invalid characters such as “, <, >, or |.

PathTooLongException

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.

IOException

sourceDirectory’ stands for a file, not for a directory.

CreateEntries(دایرکتوریInfo، bool، XarCompressionSettings)

اضافه کردن به آرشیو تمام فایل ها و دایرکتوری ها به طور تکراری در دایرکتوری داده شده.

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

Parameters

directory DirectoryInfo

دستورالعمل برای فشرده سازی

includeRootDirectory bool

نشان می دهد که آیا باید خود دایرکتوری ریشه را شامل شود یا نه.

compressionSettings XarCompressionSettings

تنظیمات فشرده سازی برای اضافه کردن عناصر Aspose.Zip.Xar.XarEntry استفاده می شود.

Returns

XarArchive

محدوده ورودی

Examples 

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
        archive.Save(xarFile);
    }
}

Exceptions

ArgumentNullException

directory’ is null.

SecurityException

تماس گیرنده اجازه لازم برای دسترسی به directory را ندارد.

IOException

directory’ stands for a file, not for a directory.

CreateEntry(کلمات کلیدی, FileInfo, Bool, XarCompressionSettings)

یک ورودی واحد در آرشیو ایجاد کنید.

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

Parameters

name string

نام ورودی

fileInfo FileInfo

فایلهای فایل یا پوشه ای که باید فشرده شود.

openImmediately bool

درست است، اگر فایل را بلافاصله باز کنید، در غیر این صورت فایل را در ذخیره سازی آرشیو باز کنید.

compressionSettings XarCompressionSettings

تنظیمات فشرده سازی مورد استفاده برای اضافه کردن Aspose.Zip.Xar.XarEntry آیتم.

Returns

XarEntry

محدوده ورودی

Examples 

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.xar");
}

Remarks

اگر فایل بلافاصله با پارامتر باز شود، تا زمانی که فایل حذف شود، مسدود می شود.

Exceptions

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(قاشق، قاشق، قاشق، XarCompressionSettings)

یک ورودی واحد در آرشیو ایجاد کنید.

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

Parameters

name string

نام ورودی

sourcePath string

راهی برای فشرده سازی است.

openImmediately bool

درست است، اگر فایل را بلافاصله باز کنید، در غیر این صورت فایل را در ذخیره سازی آرشیو باز کنید.

compressionSettings XarCompressionSettings

تنظیمات فشرده سازی مورد استفاده برای اضافه کردن Aspose.Zip.Xar.XarEntry آیتم.

Returns

XarEntry

محدوده ورودی

Examples 

using (var archive = new XarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.xar");
}

Remarks

نام ورودی فقط در پارامتر تنظیم می شود نام فایل ارائه شده در پارامتر بر نام ورودی تاثیر نمی گذارد.

اگر فایل بلافاصله با پارامتر باز شود، تا زمانی که فایل حذف شود، مسدود می شود.

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

متقاضی مجوز لازم برای دسترسی ندارد.

ArgumentException

کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه

UnauthorizedAccessException

دسترسی به فایل sourcePath” رد می شود.

PathTooLongException

به عنوان مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد. - یا - name’ برای xar بیش از حد طولانی است.

NotSupportedException

فایل در sourcePath" حاوی یک ستون (:) در وسط نوار است.

InvalidOperationException

نمی توانم آرشیو را تغییر دهم.

CreateEntry(جریان، جریان، XarCompressionSettings)

یک ورودی واحد در آرشیو ایجاد کنید.

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

Parameters

name string

نام ورودی

source Stream

جریان ورودی برای ورودی

compressionSettings XarCompressionSettings

تنظیمات فشرده سازی مورد استفاده برای اضافه کردن Aspose.Zip.Xar.XarEntry آیتم.

Returns

XarEntry

محدوده ورودی

Examples 

using (var archive = new XarArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.xar");
}

Exceptions

ArgumentNullException

name’ is null.

ArgumentNullException

source’ is null.

ArgumentException

name’ is empty.

InvalidOperationException

نمی توانم آرشیو را تغییر دهم.

DeleteEntry(XarEntry)

اولین ظهور یک ورودی خاص را از لیست ورودی حذف می کند.

public XarArchive DeleteEntry(XarEntry entry)

Parameters

entry XarEntry

ورودی برای حذف از لیست ورودی ها

Returns

XarArchive

محدوده ورودی

Examples

در اینجا شما می توانید تمام ورودی ها را به جز آخرین را حذف کنید:

using (var archive = new XarArchive("archive.xar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries.FirstOrDefault());
    archive.Save(outputXarFile);
}

Exceptions

ArgumentNullException

entry’ is null.

Dispose()

انجام وظایف تعیین شده در برنامه مرتبط با آزاد کردن، آزاد کردن و یا بازگرداندن منابع غیر مدیریت شده.

public void Dispose()

Dispose(بول)

انجام وظایف تعیین شده در برنامه مرتبط با آزاد کردن، آزاد کردن و یا بازگرداندن منابع غیر مدیریت شده.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

آیا منابع مدیریت شده باید از بین برود؟

ExtractToDirectory(String)

تمام فایل ها را در آرشیو به دایرکتوری ارائه شده استخراج کنید.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

مسیر به دایرکتوری برای قرار دادن فایل های استخراج شده در.

Examples 

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

Remarks

اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.

Exceptions

ArgumentNullException

مسیر صفر است

PathTooLongException

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.

SecurityException

تماس گیرنده اجازه لازم برای دسترسی به دایرکتوری موجود را ندارد.

NotSupportedException

اگر دایرکتوری وجود ندارد، مسیر حاوی یک کاراکتر ستون فقرات (:) است که بخشی از یک برچسب درایو نیست (“C:”).

ArgumentException

مسیر یک ردیف صفر طول است، حاوی فقط فضای سفید است، یا حاوی یک یا چند کاراکتر نادرست است. شما می توانید برای کاراکتر نادرست با استفاده از روش System.IO.Path.GetInvalidPathChars درخواست کنید. -یا- مسیر با، یا حاوی، تنها یک کاراکتر ستون فقرات (:).

IOException

دایرکتوری مشخص شده توسط مسیر یک فایل است. -یا- نام شبکه شناخته نشده است.

InvalidDataException

این آرشیو خراب شده است.

Save(برچسب ها: XarSaveOptions)

ذخیره آرشیو به فایل مقصد ارائه شده.

public void Save(string destinationFileName, XarSaveOptions saveOptions = null)

Parameters

destinationFileName string

اگر نام فایل مشخص شده به یک فایل موجود اشاره کند، آن را بیش از حد نوشته خواهد شد.

saveOptions XarSaveOptions

گزینه ها برای ذخیره آرشیو با.

Exceptions

ArgumentNullException

destinationFileName’ is null.

InvalidOperationException

نمی توانم آرشیو را تغییر دهم.

Save(جریان، XarSaveOptions)

ذخیره آرشیو به جریان ارائه شده.

public void Save(Stream output, XarSaveOptions saveOptions = null)

Parameters

output Stream

جریان مقصد

saveOptions XarSaveOptions

گزینه ها برای ذخیره آرشیو با.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’Is not writable/readable or not seekable.

InvalidOperationException

نمی توانم آرشیو را تغییر دهم.

 فارسی