Class SnappyArchive

source غير قابل للبحث.

source هو null.

SnappyArchive(string)

يهيئ مثيلًا جديدًا من فئة Aspose.Zip.Snappy.SnappyArchive معدًا لفك الضغط.

public SnappyArchive(string path)

المعلمات

path string

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

أمثلة

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new SnappyArchive(sourceSnappyFile))
    {
         archive.Extract(extractedFile);
    }
   }

ملاحظات

لا يقوم هذا المنشئ بفك الضغط. راجع طريقة Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) لفك الضغط.

الاستثناءات

path هو null.

لا يمتلك المتصل الإذن المطلوب للوصول.

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

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

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

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

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

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

InvalidOperationException

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

الطرق

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

المعلمات

disposing bool

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

Extract(Stream)

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

public void Extract(Stream destination)

المعلمات

destination Stream

دفق لتخزين البيانات المفككة.

أمثلة

using (FileStream sourceSnappyFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
       using (var archive = new SnappyArchive(sourceSnappyFile))
       {
           archive.Extract(extractedFile);
       }
   }
}

الاستثناءات

لم يتم قراءة رؤوس الأرشيف ومعلومات الخدمة.

InvalidDataException

خطأ في البيانات في الرأس أو في مجموع التحقق.

دفق الوجهة هو null.

InvalidOperationException

دفق الوجهة لا يدعم الكتابة.

Extract(FileInfo)

يستخرج أرشيف سنابي إلى ملف.

public void Extract(FileInfo fileInfo)

المعلمات

fileInfo FileInfo

معلومات الملف لتخزين البيانات المفككة.

أمثلة

using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new SnappyArchive(snappyFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

الاستثناءات

لم يتم قراءة رؤوس الأرشيف ومعلومات الخدمة.

لا يمتلك المتصل الإذن المطلوب لفتح fileInfo.

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

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

المسار إلى الملف للقراءة فقط أو هو دليل.

fileInfo هو null.

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

InvalidOperationException

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

Extract(string)

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

public FileInfo Extract(string path)

المعلمات

path string

المسار إلى الملف الذي سيخزن البيانات المفككة.

العائدات

FileInfo

مثيل System.IO.FileInfo يحتوي على البيانات المستخرجة.

أمثلة

using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new SnappyArchive(snappyFile))
    {
        archive.Extract("extracted.bin");
    }
}

الاستثناءات

لم يتم قراءة رؤوس الأرشيف ومعلومات الخدمة.

path هو null.

لا يمتلك المتصل الإذن المطلوب للوصول.

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

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

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

المعلمات

destinationDirectory string

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

ملاحظات

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

الاستثناءات

destinationDirectory هو null.

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

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

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

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

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

Save(Stream)

يحفظ أرشيف سنابي إلى الدفق المقدم.

public void Save(Stream output)

المعلمات

output Stream

دفق الوجهة.

أمثلة

using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
    using (var archive = new SnappyArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(snappyFile);
     }
}

ملاحظات

output يجب أن يكون قابلاً للبحث.

الاستثناءات

output لا يدعم البحث.

output هو null.

Save(FileInfo)

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

public void Save(FileInfo destination)

المعلمات

destination FileInfo

معلومات الملف التي ستفتح كدفق وجهة.

أمثلة

using (var archive = new SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.snappy"));
}

الاستثناءات

لا يمتلك المتصل الإذن المطلوب لفتح destination.

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

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

المسار إلى الملف للقراءة فقط أو هو دليل.

destination هو null.

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

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

Save(string)

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

public void Save(string destinationFileName)

المعلمات

destinationFileName string

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

أمثلة

using (var archive = new SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.snappy");
}

الاستثناءات

destinationFileName هو null.

لا يمتلك المتصل الإذن المطلوب للوصول.

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

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

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

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

SetSource(Stream)

يحدد المحتوى الذي سيتم ضغطه داخل الأرشيف.

public void SetSource(Stream source)

المعلمات

source Stream

الدفق المدخل للأرشيف.

أمثلة

using (var archive = new SnappyArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.snappy");
}

الاستثناءات

دفق source غير قابل للبحث.

SetSource(FileInfo)

يحدد المحتوى الذي سيتم ضغطه داخل الأرشيف.

public void SetSource(FileInfo fileInfo)

المعلمات

fileInfo FileInfo

معلومات الملف التي ستفتح كدفق مدخل.

أمثلة

using (var archive = new SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.snappy");
}

الاستثناءات

لا يمتلك المتصل الإذن المطلوب لفتح fileInfo.

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

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

المسار إلى الملف للقراءة فقط أو هو دليل.

fileInfo هو null.

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

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

SetSource(string)

يحدد المحتوى الذي سيتم ضغطه داخل الأرشيف.

public void SetSource(string sourcePath)

المعلمات

sourcePath string

مسار الملف الذي سيتم فتحه كدفق مدخل.

أمثلة

using (var archive = new SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snappy");
}

الاستثناءات

sourcePath هو null.

لا يمتلك المتصل الإذن المطلوب للوصول.

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

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

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