Class SnappyArchive

Class SnappyArchive

اسم الفضاء : Aspose.Zip.Snappy تجميع: Aspose.Zip.dll (25.5.0)

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

public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object SnappyArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

الأعضاء الموروثين

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

Constructors

SnappyArchive()

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

public SnappyArchive()

Examples

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

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

SnappyArchive(Stream)

يبدأ مثالًا جديدًا من فئة Aspose.Zip.Snappy.SnappyArchive مستعدة للتخفيف.

public SnappyArchive(Stream source)

Parameters

source Stream

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

Remarks

انظر Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) طريقة للتخفيف من الضغط.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

SnappyArchive(الستار)

يبدأ مثالًا جديدًا من فئة Aspose.Zip.Snappy.SnappyArchive مستعدة للتخفيف.

public SnappyArchive(string path)

Parameters

path string

الطريق إلى مصدر الأرشيف.

Examples

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

Remarks

انظر Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) طريقة للتخفيف من الضغط.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

Methods

Dispose()

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

public void Dispose()

Dispose(بول)

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

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

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

Extract(Stream)

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

public void Extract(Stream destination)

Parameters

destination Stream

تدفق لتخزين البيانات المضغوطة.

Examples

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

Exceptions

InvalidOperationException

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

InvalidDataException

خطأ في البيانات في العنوان أو التفتيش.

ArgumentNullException

تدفق الوجهة صفر.

ArgumentException

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

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo لتخزين البيانات المضغوطة

Examples

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

Exceptions

InvalidOperationException

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

SecurityException

لا يحصل المتصل على السماح المطلوب لفتح fileInfo'.

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

Extract(الستار)

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

public FileInfo Extract(string path)

Parameters

path string

الطريق إلى الملف الذي سيتم تخزين البيانات المضغوطة.

Returns

FileInfo

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

Examples

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

Exceptions

InvalidOperationException

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

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

ExtractToDirectory(الستار)

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

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

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

Remarks

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

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

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

Save(Stream)

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

public void Save(Stream output)

Parameters

output Stream

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

Examples

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

Remarks

يجب أن تكون قابلة للبحث.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(FileInfo)

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

public void Save(FileInfo destination)

Parameters

destination FileInfo

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

Examples

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

Exceptions

SecurityException

لا يحصل المتصل على السماح المطلوب لفتح destination".

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

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

IOException

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

Save(الستار)

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

public void Save(string destinationFileName)

Parameters

destinationFileName string

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

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

SetSource(Stream)

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

public void SetSource(Stream source)

Parameters

source Stream

تدفق الدخول إلى الأرشيف.

Examples

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

Exceptions

ArgumentException

تدفق المصدر غير قابل للبحث.

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo، والتي سيتم فتحها كدخول تدفق.

Examples

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

Exceptions

SecurityException

لا يحصل المتصل على السماح المطلوب لفتح fileInfo'.

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

SetSource(الستار)

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

public void SetSource(string sourcePath)

Parameters

sourcePath string

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

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 عربي