Class XarArchive

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`

path’ is null.

لا يحصل المتصل على إذن الوصول المطلوب.

UnauthorizedAccessException

الطريق " فارغ ، يحتوي على مساحات بيضاء فقط ، أو يحتوي على أحرف غير صحيحة.

يتم رفض الوصول إلى ملف path".

DirectoryNotFoundException

على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.

NotSupportedException

ملف في path’ يحتوي على عمود (:) في وسط السلسلة.

FileNotFoundException

لم يتم العثور على الملف.

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

الملف مفتوح بالفعل.

InvalidDataException

الملف في path’ غير صالحة أرشيف xar.

`Properties`

`Entries`

يحصل على إدخالات من Aspose.Zip.Xar.XarEntry النوع الذي يشكل الأرشيف.

public IEnumerable<xarentry> Entries { get; }

`قيمة الممتلكات`

IEnumerable &lt؛ XarEntry >

`Methods`

`CreateEntries(قوس قزح، قوس قزح، قوس قزح)`

إضافة إلى الأرشيف جميع الملفات والمجلدات مرارا وتكرارا في الدليل المحدد.

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

`Parameters`

sourceDirectory string

فيديوهات متعلقة بـ Compress

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`

sourceDirectory’ is null.

لا يتمتع المكالمة بالترخيص المطلوب للوصول إلى sourceDirectory'.

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

المسار المحدد، اسم الملف، أو كلاهما يتجاوز الحد الأقصى المحدد النظام. على سبيل المثال، على منصات ويندوز، يجب أن تكون المسارات أقل من 248 حرف، وأسماء الملفات يجب أن تكون أقل من 260 حرف.

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

`CreateEntries(DirectoryInfo, bool, XarCompressionإعدادات)`

إضافة إلى الأرشيف جميع الملفات والمجلدات مرارا وتكرارا في الدليل المحدد.

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

`Parameters`

directory DirectoryInfo

فيديوهات متعلقة بـ Compress

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`

directory’ is null.

لا يحصل المتصل على السماح المطلوب للوصول إلى directory”.

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`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(قوس قزح، قوس قزح، قوس قزح)`

إنشاء إدخال واحد داخل الأرشيف.

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`

sourcePath’ is null.

لا يحصل المتصل على إذن الوصول المطلوب.

UnauthorizedAccessException

فالمصدر sourcePath’ فارغ، يحتوي فقط على مساحات بيضاء، أو يحتوي على أحرف غير صحيحة. - أو - اسم الملف، كجزء من name"، يتجاوز 100 رمز.

يتم رفض الوصول إلى ملف sourcePath'.

على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا. - أو - name’ طويل جدًا لـ xar.

NotSupportedException

ملف في sourcePath’ يحتوي على عمود (:) في وسط السلسلة.

من المستحيل تعديل أرشيف.

`CreateEntry(الشريط, Stream, 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`

name’ is null.

source’ is null.

name’ is empty.

من المستحيل تعديل أرشيف.

`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`

entry’ is null.

`Dispose()`

يمارس المهام المحددة في التطبيق المرتبطة بتفريغ أو إطلاق أو إعادة تدوير الموارد غير المعالجة.

public void Dispose()

`Dispose(بول)`

يمارس المهام المحددة في التطبيق المرتبطة بتفريغ أو إطلاق أو إعادة تدوير الموارد غير المعالجة.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

هل ينبغي تخصيص الموارد التي يتم إدارةها؟

`ExtractToDirectory(الستار)`

استخراج جميع الملفات في الأرشيف إلى الدليل المقدمة.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

الطريق إلى الدليل لوضع الملفات المستخرجة في.

`Examples`

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

`Remarks`

إذا لم يكن الدليل موجودًا ، فسيتم إنشاؤه.

`Exceptions`

الطريق صفر

على سبيل المثال، على منصات ويندوز، يجب أن تكون المسارات أقل من 248 حرف، وأسماء الملفات يجب أن تكون أقل من 260 حرف.

لا يتمتع المكالمة بالترخيص المطلوب للوصول إلى الدليل الحالي.

NotSupportedException

إذا لم يكن الدليل موجودًا ، فإن المسار يحتوي على حرف العمود الفقري (:) الذي ليس جزءًا من علامة محرك الأقراص (“C:”).

المسار هو سلسلة صفر الطول، يحتوي فقط على مساحة بيضاء، أو يحتوي على شخصية واحدة أو أكثر غير مؤهلة.يمكنك الاستعلام عن شخصيات غير مؤهلة باستخدام طريقة System.IO.Path.GetInvalidPathChars. -أو- المسار محدد مسبقا مع، أو يحتوي، فقط حرف العمود الفقري (:).

المجلد المحدد بالطريق هو ملف. -أو- اسم الشبكة غير معروف.

InvalidDataException

وقد تم تدمير الأرشيف

`Save(الخيارات، XarSaveOptions)`

حفظ الأرشيف إلى ملف الوجهة المقدمة.

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

`Parameters`

destinationFileName string

إذا كان اسم الملف المحدد يشير إلى ملف موجود ، فسيتم إعادة كتابته.

saveOptions XarSaveOptions

خيارات لتخزين أرشيف xar مع.

`Exceptions`

destinationFileName’ is null.

من المستحيل تعديل أرشيف.

`Save(تداول الخيارات، XarSaveOptions)`

حفظ الأرشيف إلى التدفق المقدم.

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

`Parameters`

output Stream

النطاق المستهدف

saveOptions XarSaveOptions

خيارات لتخزين أرشيف xar مع.

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.