Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
تمثل هذه الفئة ملف أرشيف Z (ضغط). استخدمها لتكوين أو استخراج أرشيفات Z.
public class ZArchive : 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()
ملاحظات
انظر https://docs.fileformat.com/compression/z/
المُنشئات
ZArchive()
يُهيئ مثيلًا جديدًا من فئة Aspose.Zip.Z.ZArchive مُعدًا للضغط.
public ZArchive()
ZArchive(Stream, ZArchiveLoadOptions)
يُهيئ مثيلًا جديدًا من فئة Aspose.Zip.Z.ZArchive مُعدًا لفك الضغط.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)
المعلمات
source
Stream
مصدر الأرشيف.
loadOptions
ZArchiveLoadOptions
الخيارات لتحميل الأرشيف بها.
ملاحظات
لا يقوم هذا المُنشئ بفك الضغط. انظر طريقة Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) لفك الضغط.
الاستثناءات
source
غير قابل للبحث.
source
فارغ.
ZArchive(string, ZArchiveLoadOptions)
يُهيئ مثيلًا جديدًا من فئة Aspose.Zip.Z.ZArchive مُعدًا لفك الضغط.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)
المعلمات
path
string
المسار إلى مصدر الأرشيف.
loadOptions
ZArchiveLoadOptions
الخيارات لتحميل الأرشيف بها.
ملاحظات
لا يقوم هذا المُنشئ بفك الضغط. انظر طريقة Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) لفك الضغط.
الاستثناءات
path
فارغ.
المستدعي ليس لديه الإذن المطلوب للوصول.
path
فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى ملف path
.
path
أو اسم الملف المحدد، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة القائمة على Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في path
يحتوي على نقطتين (:) في منتصف السلسلة.
لم يتم العثور على الملف.
المسار المحدد غير صالح، مثل أن يكون على محرك غير محدد.
الملف مفتوح بالفعل.
الطرق
Dispose()
ينفذ مهام محددة من قبل التطبيق مرتبطة بتحرير أو إعادة تعيين الموارد غير المُدارة.
public void Dispose()
Dispose(bool)
ينفذ مهام محددة من قبل التطبيق مرتبطة بتحرير أو إعادة تعيين الموارد غير المُدارة.
protected virtual void Dispose(bool disposing)
المعلمات
disposing
bool
ما إذا كانت الموارد المُدارة يجب أن يتم التخلص منها.
Extract(Stream)
يستخرج أرشيف Z إلى دفق.
public void Extract(Stream destination)
المعلمات
destination
Stream
دفق لتخزين البيانات المُفككة.
أمثلة
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(extractedFile);
}
}
}
الاستثناءات
لا يمكن فك ضغط البيانات.
Extract(FileInfo)
يستخرج أرشيف Z إلى ملف.
public void Extract(FileInfo fileInfo)
المعلمات
fileInfo
FileInfo
معلومات الملف لتخزين البيانات المُفككة.
أمثلة
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
الاستثناءات
المستدعي ليس لديه الإذن المطلوب لفتح fileInfo
.
مسار الملف فارغ أو يحتوي فقط على مسافات بيضاء.
لم يتم العثور على الملف.
المسار إلى الملف للقراءة فقط أو هو دليل.
fileInfo
فارغ.
المسار المحدد غير صالح، مثل أن يكون على محرك غير محدد.
الملف مفتوح بالفعل.
لا يمكن فك ضغط البيانات.
Extract(string)
يستخرج أرشيف Z إلى ملف بواسطة المسار.
public FileInfo Extract(string path)
المعلمات
path
string
المسار إلى الملف الذي سيخزن البيانات المُفككة.
Returns
معلومات الملف المستخرج.
أمثلة
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
الاستثناءات
path
فارغ.
المستدعي ليس لديه الإذن المطلوب للوصول.
path
فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى ملف path
.
path
أو اسم الملف المحدد، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة القائمة على Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في path
يحتوي على نقطتين (:) في منتصف السلسلة.
لا يمكن فك ضغط البيانات.
ExtractToDirectory(string)
يستخرج محتوى الأرشيف إلى الدليل المحدد.
public void ExtractToDirectory(string destinationDirectory)
المعلمات
destinationDirectory
string
المسار إلى الدليل لوضع الملفات المستخرجة فيه.
ملاحظات
إذا لم يكن الدليل موجودًا، سيتم إنشاؤه.
الاستثناءات
destinationDirectory
فارغ.
path
أو اسم الملف المحدد، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة القائمة على Windows، يجب أن تكون المسارات أقل من 248 حرفًا وأسماء الملفات أقل من 260 حرفًا.
المستدعي ليس لديه الإذن المطلوب للوصول إلى الدليل الموجود.
إذا لم يكن الدليل موجودًا، يحتوي المسار على حرف نقطتين (:) غير جزء من تسمية محرك (“C:").
destinationDirectory
هو سلسلة بطول صفر، يحتوي فقط على مساحات بيضاء، أو يحتوي على حرف غير صالح أو أكثر. يمكنك الاستعلام عن الأحرف غير الصالحة باستخدام طريقة System.IO.Path.GetInvalidPathChars.
-أو- المسار مُسبق بـ، أو يحتوي فقط على حرف نقطتين (:).
الدليل المحدد بواسطة المسار هو ملف. -أو- اسم الشبكة غير معروف.
Save(Stream, ZArchiveSaveOptions)
يحفظ أرشيف xz إلى الدفق المقدم.
public void Save(Stream output, ZArchiveSaveOptions settings = null)
المعلمات
output
Stream
دفق الوجهة.
settings
ZArchiveSaveOptions
إعدادات اختيارية لتكوين الأرشيف.
أمثلة
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}
ملاحظات
output
يجب أن يكون قابلًا للبحث.
الاستثناءات
output
لا يدعم البحث.
output
فارغ.
Save(string, ZArchiveSaveOptions)
يحفظ أرشيف Z إلى ملف الوجهة المقدم.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)
المعلمات
destinationFileName
string
+المسار للأرشيف الذي سيتم إنشاؤه. إذا كان اسم الملف المحدد يشير إلى ملف موجود، فسيتم الكتابة فوقه.
settings
ZArchiveSaveOptions
إعدادات اختيارية لتكوين الأرشيف.
أمثلة
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
الاستثناءات
destinationFileName
فارغ.
المستدعي ليس لديه الإذن المطلوب للوصول.
destinationFileName
فارغ، يحتوي فقط على مساحات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى ملف destinationFileName
.
destinationFileName
أو اسم الملف المحدد، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة القائمة على Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في destinationFileName
يحتوي على نقطتين (:) في منتصف السلسلة.
SetSource(Stream)
يحدد المحتوى الذي سيتم ضغطه داخل الأرشيف.
public void SetSource(Stream source)
المعلمات
source
Stream
الدفق المدخل للأرشيف.
أمثلة
using (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}
SetSource(FileInfo)
يحدد المحتوى الذي سيتم ضغطه داخل الأرشيف.
public void SetSource(FileInfo fileInfo)
المعلمات
fileInfo
FileInfo
معلومات الملف التي سيتم فتحها كدفق مدخل.
أمثلة
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
الاستثناءات
المستدعي ليس لديه الإذن المطلوب لفتح fileInfo
.
مسار الملف فارغ أو يحتوي فقط على مسافات بيضاء.
لم يتم العثور على الملف.
المسار إلى الملف للقراءة فقط أو هو دليل.
fileInfo
فارغ.
المسار المحدد غير صالح، مثل أن يكون على محرك غير محدد.
الملف مفتوح بالفعل.
SetSource(string)
يحدد المحتوى الذي سيتم ضغطه داخل الأرشيف.
public void SetSource(string sourcePath)
المعلمات
sourcePath
string
المسار إلى الملف الذي سيتم فتحه كدفق مدخل.
أمثلة
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}
الاستثناءات
sourcePath
فارغ أو سلسلة فارغة.
المستدعي ليس لديه الإذن المطلوب للوصول إلى مورد.
sourcePath
فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى ملف sourcePath
.
sourcePath
أو اسم الملف المحدد، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة القائمة على Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في sourcePath
يحتوي على نقطتين (:) في منتصف السلسلة.