Class SnappyArchive
Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)
تمثل هذه الفئة ملف أرشيف سنابي. استخدمها لتكوين أو استخراج أرشيفات سنابي.
public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry
الوراثة
تطبيقات
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) لفك الضغط.
الاستثناءات
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
على نقطتين (:) في منتصف السلسلة.
لم يتم العثور على الملف.
المسار المحدد غير صالح، مثل كونه على محرك غير مُعَلم.
الملف مفتوح بالفعل.
الطرق
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);
}
}
}
الاستثناءات
لم يتم قراءة رؤوس الأرشيف ومعلومات الخدمة.
خطأ في البيانات في الرأس أو في مجموع التحقق.
دفق الوجهة هو null.
دفق الوجهة لا يدعم الكتابة.
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.
المسار المحدد غير صالح، مثل كونه على محرك غير مُعَلم.
الملف مفتوح بالفعل.
Extract(string)
يستخرج أرشيف سنابي إلى ملف عبر المسار.
public FileInfo Extract(string path)
المعلمات
path
string
المسار إلى الملف الذي سيخزن البيانات المفككة.
العائدات
مثيل 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
المحدد، أو اسم الملف، أو كليهما الطول الأقصى المحدد بواسطة النظام. على سبيل المثال، على أنظمة Windows، يجب أن تكون المسارات أقل من 248 حرفًا، وأسماء الملفات أقل من 260 حرفًا.
يحتوي الملف في 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 حرفًا.
يحتوي الملف في sourcePath
على نقطتين (:) في منتصف السلسلة.