Class ZstandardArchive

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

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

public class ZstandardArchive : IArchive, IDisposable, IArchiveFileEntry

الوراثة

object ← ZstandardArchive

التنفيذ

IArchive, IDisposable, IArchiveFileEntry

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

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

المُنشئات

ZstandardArchive()

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

public ZstandardArchive()

أمثلة

المثال التالي يوضح كيفية ضغط ملف.

using (ZstandardArchive archive = new ZstandardArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.zst");
}

ZstandardArchive(Stream, ZstandardLoadOptions)

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

public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)

المعلمات

sourceStream Stream

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

options ZstandardLoadOptions

الخيارات لتحميل الأرشيف بها.

أمثلة

افتح أرشيفًا من تدفق واستخراجه إلى MemoryStream

var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
  archive.Open().CopyTo(ms);

ملاحظات

هذا المُنشئ لا يقوم بفك الضغط. راجع طريقة Aspose.Zip.Zstandard.ZstandardArchive.Open لفك الضغط.

ZstandardArchive(string, ZstandardLoadOptions)

يهيئ مثيلًا جديدًا من فئة Aspose.Zip.Zstandard.ZstandardArchive.

public ZstandardArchive(string path, ZstandardLoadOptions options = null)

المعلمات

path string

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

options ZstandardLoadOptions

الخيارات لتحميل الأرشيف بها.

أمثلة

افتح أرشيفًا من ملف حسب المسار واستخراجه إلى MemoryStream

var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
  archive.Open().CopyTo(ms);

ملاحظات

هذا المُنشئ لا يقوم بفك الضغط. راجع طريقة Aspose.Zip.Zstandard.ZstandardArchive.Open لفك الضغط.

الاستثناءات

ArgumentNullException

path هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

الملف في 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 (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

الاستثناءات

ArgumentException

destination لا يدعم الكتابة.

Extract(string)

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

public FileInfo Extract(string path)

المعلمات

path string

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

العائدات

FileInfo

معلومات الملف المستخرج.

الاستثناءات

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

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

Open()

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

public Stream Open()

العائدات

Stream

التدفق الذي يمثل محتويات الأرشيف.

أمثلة

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

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

يمكنك استخدام طريقة Stream.CopyTo للإصدارات .NET 4.0 وما فوق: `unpacked.CopyTo(extracted);`

ملاحظات

اقرأ من التدفق للحصول على المحتوى الأصلي للملف. راجع قسم الأمثلة.

Save(Stream, ZstandardSaveOptions)

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

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

المعلمات

outputStream Stream

تدفق الوجهة.

settings ZstandardSaveOptions

إعدادات اختيارية لتكوين الأرشيف.

أمثلة

يكتب البيانات المضغوطة إلى تدفق استجابة http.

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

ملاحظات

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

الاستثناءات

ArgumentException

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

InvalidOperationException

لم يتم توفير المصدر.

Save(string, ZstandardSaveOptions)

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

public void Save(string destinationFileName, ZstandardSaveOptions settings = null)

المعلمات

destinationFileName string

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

settings ZstandardSaveOptions

إعدادات اختيارية لتكوين الأرشيف.

أمثلة

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

الاستثناءات

ArgumentNullException

destinationFileName هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

Save(FileInfo, ZstandardSaveOptions)

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

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

المعلمات

destination FileInfo

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

settings ZstandardSaveOptions

إعدادات اختيارية لتكوين الأرشيف.

أمثلة

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

الاستثناءات

SecurityException

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

ArgumentException

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

FileNotFoundException

الملف غير موجود.

UnauthorizedAccessException

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

ArgumentNullException

destination هو null.

DirectoryNotFoundException

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

IOException

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

SetSource(Stream)

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

public void SetSource(Stream source)

المعلمات

source Stream

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

أمثلة

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

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

المعلمات

fileInfo FileInfo

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

أمثلة

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

SetSource(string)

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

public void SetSource(string path)

المعلمات

path string

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

أمثلة

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

الاستثناءات

ArgumentNullException

path هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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