Class CpioArchive

sourceStream هو null.

sourceStream ليس قابلاً للبحث.

InvalidDataException

sourceStream ليس أرشيف cpio صالح.

CpioArchive(string)

يبدأ مثيلًا جديدًا من فئة Aspose.Zip.Cpio.CpioArchive ويقوم بتكوين قائمة الإدخالات التي يمكن استخراجها من الأرشيف.

public CpioArchive(string path)

المعلمات

path string

مسار ملف الأرشيف.

أمثلة

يوضح المثال التالي كيفية استخراج جميع الإدخالات إلى دليل.

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

ملاحظات

لا يقوم هذا المُنشئ بفك أي إدخال. انظر طريقة Aspose.Zip.Cpio.CpioEntry.Open لفك الضغط.

الاستثناءات

path هو null.

المتصل ليس لديه الإذن المطلوب للوصول.

UnauthorizedAccessException

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

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

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

DirectoryNotFoundException

الملف في path يحتوي على نقطتين (:) في منتصف السلسلة.

FileNotFoundException

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

المسار المحدد غير صالح، مثل كونه على محرك غير مخصص.

ReadOnlyCollection<CpioEntry>

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

الخصائص

Entries

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

public ReadOnlyCollection<cpioentry> Entries { get; }

قيمة الخاصية

الطرق

CreateEntries(string, bool)

يضيف إلى الأرشيف جميع الملفات والدلائل بشكل متكرر في الدليل المعطى.

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

المعلمات

sourceDirectory string

الدليل الذي سيتم ضغطه.

includeRootDirectory bool

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

العائدات

مثيل إدخال cpio.

أمثلة

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

الاستثناءات

sourceDirectory هو null.

المتصل ليس لديه الإذن المطلوب للوصول إلى sourceDirectory.

sourceDirectory يحتوي على أحرف غير صالحة مثل “، <، >، أو |.

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

sourceDirectory يمثل ملفًا، وليس دليلًا.

CreateEntries(DirectoryInfo, bool)

يضيف إلى الأرشيف جميع الملفات والدلائل بشكل متكرر في الدليل المعطى.

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

المعلمات

directory DirectoryInfo

الدليل الذي سيتم ضغطه.

includeRootDirectory bool

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

العائدات

مثيل إدخال cpio.

أمثلة

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

الاستثناءات

directory هو null.

المتصل ليس لديه الإذن المطلوب للوصول إلى directory.

directory يمثل ملفًا، وليس دليلًا.

CreateEntry(string, FileInfo, bool)

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

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

المعلمات

name string

اسم الإدخال.

fileInfo FileInfo

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

openImmediately bool

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

العائدات

CpioEntry

مثيل إدخال cpio.

أمثلة

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

ملاحظات

إذا تم فتح الملف على الفور مع openImmediately، فإنه يصبح محجوزًا حتى يتم التخلص من الأرشيف.

الاستثناءات

name هو null.

name فارغ.

fileInfo هو null.

CreateEntry(string, string, bool)

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

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

المعلمات

name string

اسم الإدخال.

sourcePath string

المسار إلى الملف الذي سيتم ضغطه.

openImmediately bool

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

العائدات

CpioEntry

مثيل إدخال cpio.

أمثلة

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

ملاحظات

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

إذا تم فتح الملف على الفور مع openImmediately، فإنه يصبح محجوزًا حتى يتم التخلص من الأرشيف.

الاستثناءات

sourcePath هو null.

المتصل ليس لديه الإذن المطلوب للوصول.

UnauthorizedAccessException

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

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

يتجاوز المسار المحدد، اسم الملف، أو كلاهما الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على أنظمة التشغيل المعتمدة على Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا. - أو - name طويل جدًا بالنسبة لـ cpio.

الملف في sourcePath يحتوي على نقطتين (:) في منتصف السلسلة.

CreateEntry(string, Stream)

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

public CpioEntry CreateEntry(string name, Stream source)

المعلمات

name string

اسم الإدخال.

source Stream

تيار الإدخال للإدخال.

العائدات

CpioEntry

مثيل إدخال cpio.

أمثلة

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

الاستثناءات

name هو null.

source هو null.

name فارغ.

DeleteEntry(CpioEntry)

يتم إزالة أول ظهور لإدخال معين من قائمة الإدخالات.

public CpioArchive DeleteEntry(CpioEntry entry)

المعلمات

entry CpioEntry

الإدخال الذي سيتم إزالته من قائمة الإدخالات.

العائدات

مثيل إدخال cpio.

أمثلة

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

using (var archive = new CpioArchive("archive.cpio"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputCpioFile);
}

الاستثناءات

entry هو null.

DeleteEntry(int)

يتم إزالة الإدخال من قائمة الإدخالات حسب الفهرس.

public CpioArchive DeleteEntry(int entryIndex)

المعلمات

entryIndex int

الفهرس القائم على الصفر للإدخال المراد إزالته.

العائدات

ArgumentOutOfRangeException

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

أمثلة

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

الاستثناءات

entryIndex أقل من 0.-أو- entryIndex يساوي أو أكبر من عدد Entries.

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

المعلمات

disposing bool

ما إذا كانت الموارد المُدارة يجب أن يتم التخلص منها.

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

المعلمات

destinationDirectory string

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

أمثلة

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

ملاحظات

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

الاستثناءات

path هو null

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

المتصل ليس لديه الإذن المطلوب للوصول إلى الدليل الموجود.

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

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

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

Save(string, CpioFormat)

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

public void Save(string destinationFileName, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

destinationFileName string

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

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

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

ملاحظات

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

الاستثناءات

destinationFileName هو سلسلة صفرية الطول، يحتوي فقط على مسافات بيضاء، أو يحتوي على حرف واحد أو أكثر غير صالح كما هو محدد بواسطة System.IO.Path.InvalidPathChars.

destinationFileName هو null.

DirectoryNotFoundException

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

destinationFileName المحدد غير صالح، (على سبيل المثال، يكون على محرك غير مخصص).

UnauthorizedAccessException

حدث خطأ في الإدخال/الإخراج أثناء فتح الملف.

destinationFileName حدد ملفًا للقراءة فقط والوصول ليس للقراءة.-أو- المسار حدد دليلًا.-أو- المتصل ليس لديه الإذن المطلوب.

destinationFileName في تنسيق غير صالح.

Save(Stream, CpioFormat)

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

public void Save(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

output Stream

تدفق الوجهة.

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(cpioFile);
    }
}

ملاحظات

output يجب أن يكون قابلًا للكتابة.

الاستثناءات

output هو null.

output ليس قابلًا للكتابة. - أو - output هو نفس التدفق الذي نستخرج منه. - أو - من المستحيل حفظ الأرشيف في cpioFormat بسبب قيود التنسيق.

SaveGzipped(Stream, CpioFormat)

يحفظ الأرشيف في التدفق مع ضغط gzip.

public void SaveGzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

output Stream

تدفق الوجهة.

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

using (FileStream result = File.OpenWrite("result.cpio.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

ملاحظات

output يجب أن يكون قابلًا للكتابة.

الاستثناءات

output هو null.

output ليس قابلًا للكتابة.

SaveGzipped(string, CpioFormat)

يحفظ الأرشيف في الملف حسب المسار مع ضغط gzip.

public void SaveGzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

path string

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

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.cpio.gz");
    }
}

SaveLZMACompressed(Stream, CpioFormat)

يحفظ الأرشيف في التدفق مع ضغط LZMA.

public void SaveLZMACompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

output Stream

تدفق الوجهة.

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

using (FileStream result = File.OpenWrite("result.cpio.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

ملاحظات

output يجب أن يكون قابلًا للكتابة.

مهم: يتم تكوين أرشيف cpio ثم ضغطه داخل هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

SaveLZMACompressed(string, CpioFormat)

يحفظ الأرشيف في الملف حسب المسار مع ضغط LZMA.

public void SaveLZMACompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

path string

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

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.cpio.lzma");
    }
}

ملاحظات

مهم: يتم تكوين أرشيف cpio ثم ضغطه داخل هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

SaveLzipped(Stream, CpioFormat)

يحفظ الأرشيف في التدفق مع ضغط lzip.

public void SaveLzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

output Stream

تدفق الوجهة.

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

using (FileStream result = File.OpenWrite("result.cpio.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

ملاحظات

output يجب أن يكون قابلًا للكتابة.

الاستثناءات

output هو null.

output ليس قابلًا للكتابة.

SaveLzipped(string, CpioFormat)

يحفظ الأرشيف في الملف حسب المسار مع ضغط lzip.

public void SaveLzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

path string

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

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.cpio.lz");
    }
}

SaveXzCompressed(Stream, CpioFormat, XzArchiveSettings)

يحفظ الأرشيف في التدفق مع ضغط xz.

public void SaveXzCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)

المعلمات

output Stream

تدفق الوجهة.

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

settings XzArchiveSettings

مجموعة من إعدادات أرشيف xz المعينة: حجم القاموس، حجم الكتلة، نوع الفحص.

أمثلة

using (FileStream result = File.OpenWrite("result.cpio.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

ملاحظات

output يجب أن يكون قابلًا للكتابة.

الاستثناءات

output هو null.

output ليس قابلًا للكتابة.

SaveXzCompressed(string, CpioFormat, XzArchiveSettings)

يحفظ الأرشيف في المسار حسب المسار مع ضغط xz.

public void SaveXzCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)

المعلمات

path string

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

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

settings XzArchiveSettings

مجموعة من إعدادات أرشيف xz المعينة: حجم القاموس، حجم الكتلة، نوع الفحص.

أمثلة

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.cpio.xz");
    }
}

SaveZCompressed(Stream, CpioFormat)

يحفظ الأرشيف في التدفق مع ضغط Z.

public void SaveZCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

output Stream

تدفق الوجهة.

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

using (FileStream result = File.OpenWrite("result.cpio.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

ملاحظات

output يجب أن يكون قابلًا للكتابة.

الاستثناءات

output هو null.

output ليس قابلًا للكتابة.

SaveZCompressed(string, CpioFormat)

يحفظ الأرشيف في المسار حسب المسار مع ضغط Z.

public void SaveZCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

path string

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

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.cpio.Z");
    }
}

SaveZstandard(Stream, CpioFormat)

يحفظ الأرشيف في التدفق مع ضغط Zstandard.

public void SaveZstandard(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

المعلمات

output Stream

تدفق الوجهة.

cpioFormat CpioFormat

يحدد تنسيق رأس cpio.

أمثلة

using (FileStream result = File.OpenWrite("result.cpio.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

ملاحظات

output يجب أن يكون قابلًا للكتابة.

الاستثناءات

output هو null.