Class XzArchive
اسم الفضاء : Aspose.Zip.Xz تجميع: Aspose.Zip.dll (25.5.0)
هذه الفئة تمثل ملف الأرشيف xz. استخدمها لتكوين واستخراج الأرشيف xz.
public class XzArchive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
الأعضاء الموروثين
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
XzArchive(XzArchiveSettings)
يبدأ مثالًا جديدًا من فئة Aspose.Zip.Xz.XzArchive ويقوم بتكوين الأرشيف في تنسيق xz.
public XzArchive(XzArchiveSettings settings = null)Parameters
settings XzArchiveSettings
مجموعة إعدادات محددة xz أرشيف: حجم القاموس، حجم الكتلة، نوع التحقق.
XzArchive(Stream)
يبدأ مثالًا جديدًا من فئة Aspose.Zip.Xz.XzArchive جاهزة للتخفيف.
public XzArchive(Stream source)Parameters
source Stream
مصدر الأرشيف .
Remarks
انظر Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) طريقة للتخفيف من الضغط.
Exceptions
source’ is not seekable.
source’ is null.
XzArchive(الستار)
يبدأ مثالًا جديدًا من فئة Aspose.Zip.Xz.XzArchive جاهزة للتخفيف.
public XzArchive(string path)Parameters
path string
الطريق إلى مصدر الأرشيف.
Remarks
انظر Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) طريقة للتخفيف من الضغط.
Exceptions
path’ is null.
لا يحصل المتصل على إذن الوصول المطلوب.
الطريق " فارغ ، يحتوي على مساحات بيضاء فقط ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف path".
على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.
ملف في path’ يحتوي على عمود (:) في وسط السلسلة.
لم يتم العثور على الملف.
المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.
الملف مفتوح بالفعل.
Methods
Dispose()
يمارس المهام المحددة في التطبيق المرتبطة بتفريغ أو إطلاق أو إعادة تدوير الموارد غير المعالجة.
public void Dispose()Dispose(بول)
يمارس المهام المحددة في التطبيق المرتبطة بتفريغ أو إطلاق أو إعادة تدوير الموارد غير المعالجة.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
هل ينبغي تخصيص الموارد التي يتم إدارةها؟
Extract(Stream)
استخراج xz الأرشيف إلى تدفق.
public void Extract(Stream destination)Parameters
destination Stream
تدفق لتخزين البيانات المضغوطة.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(extractedFile);
}
}
}Exceptions
لم يتم قراءة عناوين الأرشيف ومعلومات الخدمة.
Extract(FileInfo)
استخراج xz أرشيف إلى ملف.
public void Extract(FileInfo fileInfo)Parameters
fileInfo FileInfo
FileInfo لتخزين البيانات المضغوطة
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}Exceptions
لم يتم قراءة عناوين الأرشيف ومعلومات الخدمة.
لا يحصل المتصل على السماح المطلوب لفتح fileInfo'.
مسار الملف فارغ أو يحتوي فقط على مساحات بيضاء.
لم يتم العثور على الملف.
الطريق إلى الملف هو القراءة فقط أو هو دليل.
fileInfo’ is null.
المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.
الملف مفتوح بالفعل.
Extract(الستار)
استخراج xz الأرشيف إلى ملف حسب الطريق.
public FileInfo Extract(string path)Parameters
path string
الطريق إلى الملف الذي سيتم تخزين البيانات المضغوطة.
Returns
System.IO.FileInfo الحالة التي تحتوي على البيانات المستخرجة.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}Exceptions
لم يتم قراءة عناوين الأرشيف ومعلومات الخدمة.
path’ is null.
لا يحصل المتصل على إذن الوصول المطلوب.
الطريق " فارغ ، يحتوي على مساحات بيضاء فقط ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف path".
على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.
ملف في path’ يحتوي على عمود (:) في وسط السلسلة.
لم يتم العثور على الملف.
المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.
الملف مفتوح بالفعل.
ExtractToDirectory(الستار)
استخراج محتوى الأرشيف إلى الدليل المقدم.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
الطريق إلى الدليل لوضع الملفات المستخرجة في.
Remarks
إذا لم يكن الدليل موجودًا ، فسيتم إنشاؤه.
Exceptions
destinationDirectory’ is null.
على سبيل المثال، على منصات ويندوز، يجب أن تكون المسارات أقل من 248 حرف، وأسماء الملفات يجب أن تكون أقل من 260 حرف.
لا يتمتع المكالمة بالترخيص المطلوب للوصول إلى الدليل الحالي.
إذا لم يكن الدليل موجودًا ، فإن المسار يحتوي على حرف العمود الفقري (:) الذي ليس جزءًا من علامة محرك الأقراص (“C:”).
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 (:).
المجلد المحدد بالطريق هو ملف. -أو- اسم الشبكة غير معروف.
Save(Stream)
تخزين xz الأرشيف إلى التدفق المقدمة.
public void Save(Stream output)Parameters
output Stream
النطاق المستهدف
Examples
using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save(xzFile);
}
}Remarks
يجب أن تكون قابلة للبحث.
Exceptions
output’ does not support seeking.
output’ is null.
Save(الستار)
حفظ الأرشيف xz إلى ملف الوجهة المقدمة.
public void Save(string destinationFileName)Parameters
destinationFileName string
إذا كان اسم الملف المحدد يشير إلى ملف موجود ، فسيتم إعادة كتابته.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.xz");
}Exceptions
destinationFileName’ is null.
لا يحصل المتصل على إذن الوصول المطلوب.
الوجه destinationFileName’ فارغ ، يحتوي فقط على مساحات بيضاء ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف destinationFileName'.
المحدد destinationFileName، اسم الملف، أو كلاهما يتجاوز الحد الأقصى الذي يحدده النظام.على سبيل المثال، على منصات ويندوز، يجب أن تكون المسارات أقل من 248 حرفا، وأسماء الملفات يجب أن تكون أقل من 260 حرفا.
ملف في destinationFileName’ يحتوي على عمود (:) في منتصف السلسلة.
SetSource(Stream)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(Stream source)Parameters
source Stream
تدفق الدخول إلى الأرشيف.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}Exceptions
تدفق المصدر غير قابل للبحث.
SetSource(FileInfo)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
FileInfo، والتي سيتم فتحها كدخول تدفق.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.xz");
}Exceptions
لا يحصل المتصل على السماح المطلوب لفتح fileInfo'.
مسار الملف فارغ أو يحتوي فقط على مساحات بيضاء.
لم يتم العثور على الملف.
الطريق إلى الملف هو القراءة فقط أو هو دليل.
fileInfo’ is null.
المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.
الملف مفتوح بالفعل.
SetSource(الستار)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(string sourcePath)Parameters
sourcePath string
مسار إلى الملف الذي سيتم فتحه كدخول تدفق.
Examples
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}Exceptions
sourcePath’ is null.
لا يحصل المتصل على إذن الوصول المطلوب.
sourcePath’ فارغ ، يحتوي فقط على مساحات بيضاء ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف sourcePath'.
على سبيل المثال ، على منصات ويندوز ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
ملف في sourcePath’ يحتوي على عمود (:) في وسط السلسلة.
