Class SharArchive

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

UnauthorizedAccessException

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

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

DirectoryNotFoundException

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

NotSupportedException

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

FileNotFoundException

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

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

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

`Properties`

`Entries`

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

public ReadOnlyCollection<sharentry> Entries { get; }

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

ReadOnlyCollection &lt؛ SharEntry >

`Methods`

`CreateEntries(البول، البول)`

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

public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

`Parameters`

sourceDirectory string

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

includeRootDirectory bool

إشارة إلى ما إذا كان لإدراج الدليل الجذر نفسه أم لا.

`Returns`

إشارة الدخول .

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(sharFile);
    }
}

`Exceptions`

sourceDirectory’ is null.

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

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

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

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

`CreateEntries(أرشيف الوسم : Bool)`

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

public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

`Parameters`

directory DirectoryInfo

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

includeRootDirectory bool

إشارة إلى ما إذا كان لإدراج الدليل الجذر نفسه أم لا.

`Returns`

إشارة الدخول .

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(sharFile);
    }
}

`Exceptions`

directory’ is null.

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

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

`CreateEntry(أرشيف الوسم : FileInfo, Bool)`

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

public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

`Parameters`

name string

اسم الدخول .

fileInfo FileInfo

سيتم ضغط البيانات الميتا من الملف أو المجلد.

openImmediately bool

صحيح، إذا قمت بفتح الملف على الفور، وإلا فتح الملف على حفظ الأرشيف.

`Returns`

SharEntry

إشارة الدخول .

`Examples`

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

`Remarks`

إذا تم فتح الملف على الفور مع المعيار فإنه يتم حظرها حتى يتم إزالة الأرشيف.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

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

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

public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)

`Parameters`

name string

اسم الدخول .

sourcePath string

الطريق إلى التسجيل لتكون مضغوطة.

openImmediately bool

صحيح، إذا قمت بفتح الملف على الفور، وإلا فتح الملف على حفظ الأرشيف.

`Returns`

SharEntry

إشارة الدخول .

`Examples`

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

`Remarks`

يتم تعيين اسم الإدخال فقط داخل المعلم.لا يؤثر اسم الملف المقدمة في المعلم على اسم الإدخال.

إذا تم فتح الملف على الفور مع المعيار فإنه يتم حظرها حتى يتم إزالة الأرشيف.

`Exceptions`

sourcePath’ is null.

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

UnauthorizedAccessException

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

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

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

NotSupportedException

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

`CreateEntry(الشريط , Stream)`

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

public SharEntry CreateEntry(string name, Stream source)

`Parameters`

name string

اسم الدخول .

source Stream

تدفق الدخول للمدخل.

`Returns`

SharEntry

إشارة الدخول .

`Examples`

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

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

`DeleteEntry(SharEntry)`

إزالة الحدث الأول من إدخال معين من قائمة الإدخال.

public SharArchive DeleteEntry(SharEntry entry)

`Parameters`

entry SharEntry

إدخال إزالة من قائمة الإدخالات.

`Returns`

إشارة الدخول .

`Examples`

إليك كيفية إزالة جميع الإدخالات باستثناء الأخير:

using (var archive = new SharArchive("archive.shar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputSharFile);
}

`Exceptions`

entry’ is null.

`DeleteEntry(إنت)`

إزالة الإدخال من قائمة الإدخال بواسطة المؤشر.

public SharArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

المؤشر القائم على الصفر من الدخول لإزالة.

`Returns`

ArgumentOutOfRangeException

تم حذف الأرشيف مع الإدخال.

`Examples`

using (var archive = new SharArchive("two_files.shar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.shar");
}

`Exceptions`

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

`Dispose(بول)`

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

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

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

`Dispose()`

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

public void Dispose()

`Save(الستار)`

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

public void Save(string destinationFileName)

`Parameters`

destinationFileName string

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

`Examples`

using (var archive = new SharArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("archive.shar");
}

`Remarks`

من الممكن حفظ الأرشيف في نفس المسار الذي تم تحميله من. ومع ذلك، هذا لا ينصح لأن هذا النهج يستخدم نسخ إلى ملف مؤقت.

`Exceptions`

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

destinationFileName’ is null.

DirectoryNotFoundException

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

المحدد destinationFileName’ غير صالح، (على سبيل المثال، هو على محرك أقراص غير مسجلة).

UnauthorizedAccessException

حدث خطأ I/O أثناء فتح الملف.

destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

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

`Save(Stream)`

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

public void Save(Stream output)

`Parameters`

output Stream

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

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(sharFile);
    }
}

`Remarks`

يجب أن تكون مكتوبة.

`Exceptions`

output’ is null.