Class SnappyArchive

Class SnappyArchive

Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)

تمثل هذه الفئة ملف أرشيف سنابي. استخدمها لتكوين أو استخراج أرشيفات سنابي.

public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry

الوراثة

objectSnappyArchive

تطبيقات

IArchive, IDisposable, IArchiveFileEntry

الأعضاء الموروثة

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

المنشئات

SnappyArchive()

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

public SnappyArchive()

أمثلة

يظهر المثال التالي كيفية ضغط ملف.

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

SnappyArchive(Stream)

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

public SnappyArchive(Stream source)

المعلمات

source Stream

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

ملاحظات

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

الاستثناءات

ArgumentException

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

ArgumentNullException

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) لفك الضغط.

الاستثناءات

ArgumentNullException

path هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

الطرق

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);
       }
   }
}

الاستثناءات

InvalidOperationException

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

InvalidDataException

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

ArgumentNullException

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

ArgumentException

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

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"));
    }
}

الاستثناءات

InvalidOperationException

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

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo هو null.

DirectoryNotFoundException

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

IOException

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

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");
    }
}

الاستثناءات

InvalidOperationException

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

ArgumentNullException

path هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

المعلمات

destinationDirectory string

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

ملاحظات

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

الاستثناءات

ArgumentNullException

destinationDirectory هو null.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

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 يجب أن يكون قابلاً للبحث.

الاستثناءات

ArgumentException

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

ArgumentNullException

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"));
}

الاستثناءات

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination هو null.

DirectoryNotFoundException

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

IOException

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

Save(string)

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

public void Save(string destinationFileName)

المعلمات

destinationFileName string

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

أمثلة

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

الاستثناءات

ArgumentNullException

destinationFileName هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

يحتوي الملف في 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");
}

الاستثناءات

ArgumentException

دفق 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");
}

الاستثناءات

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo هو null.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string sourcePath)

المعلمات

sourcePath string

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

أمثلة

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

الاستثناءات

ArgumentNullException

sourcePath هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 عربي