Class TarArchive

Class TarArchive

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

تُمثّل هذه الفئة ملف أرشيف tar. استخدمها لتكوين أو استخراج أو تحديث أرشيفات tar.

public class TarArchive : IArchive, IDisposable

الوراثة

object ← TarArchive

تنفيذ

IArchive, IDisposable

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

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

المُنشئات

TarArchive()

يُهيئ مثيلاً جديدًا من فئة Aspose.Zip.Tar.TarArchive.

public TarArchive()

أمثلة

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

using (var archive = new TarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.tar");
}

TarArchive(Stream)

يُهيئ مثيلاً جديدًا من فئة Aspose.Zip.Archive ويكوّن قائمة الإدخالات التي يمكن استخراجها من الأرشيف.

public TarArchive(Stream sourceStream)

المعلمات

sourceStream Stream

مصدر الأرشيف. يجب أن يكون قابلًا للبحث.

أمثلة

يوضح المثال التالي كيفية استخراج جميع الإدخالات إلى دليل.

using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{ 
   archive.ExtractToDirectory("C:\extracted");
}

ملاحظات

لا يقوم هذا المُنشئ بفك أي إدخال. راجع طريقة Aspose.Zip.Tar.TarEntry.Open لفك الضغط.

الاستثناءات

InvalidDataException

sourceStream ليس قابلًا للبحث.

TarArchive(string)

يُهيئ مثيلاً جديدًا من فئة Aspose.Zip.Tar.TarArchive ويكوّن قائمة الإدخالات التي يمكن استخراجها من الأرشيف.

public TarArchive(string path)

المعلمات

path string

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

أمثلة

يوضح المثال التالي كيفية استخراج جميع الإدخالات إلى دليل.

using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

ملاحظات

لا يقوم هذا المُنشئ بفك أي إدخال. راجع طريقة Aspose.Zip.Tar.TarEntry.Open لفك الضغط.

الاستثناءات

ArgumentNullException

path هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

الخصائص

Entries

يحصل على إدخالات من نوع Aspose.Zip.Tar.TarEntry التي تشكل الأرشيف.

public ReadOnlyCollection<tarentry> Entries { get; }

قيمة الخاصية

ReadOnlyCollection<TarEntry&gt;

الطرق

CreateEntries(DirectoryInfo, bool)

يضيف إلى الأرشيف جميع الملفات والمجلدات بشكل متكرر في الدليل المعطى.

public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

المعلمات

directory DirectoryInfo

الدليل للضغط.

includeRootDirectory bool

تشير إلى ما إذا كان يجب تضمين الدليل الجذري نفسه أم لا.

العائدات

TarArchive

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

أمثلة 

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(tarFile);
    }
}

CreateEntries(string, bool)

يضيف إلى الأرشيف جميع الملفات والمجلدات بشكل متكرر في الدليل المعطى.

public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

المعلمات

sourceDirectory string

الدليل للضغط.

includeRootDirectory bool

تشير إلى ما إذا كان يجب تضمين الدليل الجذري نفسه أم لا.

العائدات

TarArchive

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

أمثلة 

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(tarFile);
    }
}

الاستثناءات

ArgumentNullException

sourceDirectory هو null.

SecurityException

لا يمتلك المتصل الإذن المطلوب للوصول إلى sourceDirectory.

ArgumentException

sourceDirectory يحتوي على أحرف غير صالحة مثل “، <، >، أو |.

PathTooLongException

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

CreateEntry(string, Stream, FileSystemInfo)

إنشاء إدخال فردي داخل الأرشيف.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

المعلمات

name string

اسم الإدخال.

source Stream

تيار الإدخال للإدخال.

fileInfo FileSystemInfo

بيانات التعريف الخاصة بالملف أو المجلد المراد ضغطه.

العائدات

TarEntry

مثيل إدخال Tar.

أمثلة 

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

ملاحظات

يتم تعيين اسم الإدخال فقط ضمن معلمة name. اسم الملف المقدم في معلمة fileInfo لا يؤثر على اسم الإدخال.

يمكن أن تشير fileInfo إلى System.IO.DirectoryInfo إذا كان الإدخال هو دليل.

الاستثناءات

PathTooLongException

name طويل جدًا بالنسبة لـ tar وفقًا لمعيار IEEE 1003.1-1998.

ArgumentException

يتجاوز اسم الملف، كجزء من name، 100 رمزًا.

CreateEntry(string, FileInfo, bool)

إنشاء إدخال فردي داخل الأرشيف.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

المعلمات

name string

اسم الإدخال.

fileInfo FileInfo

بيانات التعريف الخاصة بالملف أو المجلد المراد ضغطه.

openImmediately bool

صحيح إذا تم فتح الملف على الفور، خلاف ذلك فتح الملف عند حفظ الأرشيف.

العائدات

TarEntry

مثيل إدخال Tar.

أمثلة 

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

ملاحظات

يتم تعيين اسم الإدخال فقط ضمن معلمة name. اسم الملف المقدم في معلمة fileInfo لا يؤثر على اسم الإدخال.

يمكن أن تشير fileInfo إلى System.IO.DirectoryInfo إذا كان الإدخال هو دليل.

إذا تم فتح الملف على الفور باستخدام معلمة openImmediately، فإنه يصبح محجوزًا حتى يتم التخلص من الأرشيف.

الاستثناءات

PathTooLongException

name طويل جدًا بالنسبة لـ tar وفقًا لمعيار IEEE 1003.1-1998.

ArgumentException

يتجاوز اسم الملف، كجزء من name، 100 رمزًا.

CreateEntry(string, string, bool)

إنشاء إدخال فردي داخل الأرشيف.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

المعلمات

name string

اسم الإدخال.

path string

المسار إلى الملف المراد ضغطه.

openImmediately bool

صحيح إذا تم فتح الملف على الفور، خلاف ذلك فتح الملف عند حفظ الأرشيف.

العائدات

TarEntry

مثيل إدخال Tar.

أمثلة 

using (var archive = new TarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save(outputTarFile);
}

ملاحظات

يتم تعيين اسم الإدخال فقط ضمن معلمة name. اسم الملف المقدم في معلمة path لا يؤثر على اسم الإدخال.

إذا تم فتح الملف على الفور باستخدام معلمة openImmediately، فإنه يصبح محجوزًا حتى يتم التخلص من الأرشيف.

الاستثناءات

ArgumentNullException

path هو null.

SecurityException

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

ArgumentException

path فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة. - أو - يتجاوز اسم الملف، كجزء من name، 100 رمزًا.

UnauthorizedAccessException

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

PathTooLongException

يتجاوز path المحدد، أو اسم الملف، أو كليهما الحد الأقصى للطول المحدد بواسطة النظام. على سبيل المثال، على الأنظمة الأساسية المعتمدة على Windows، يجب أن يكون طول المسارات أقل من 248 حرفًا، وأسماء الملفات أقل من 260 حرفًا. - أو - name طويل جدًا بالنسبة لـ tar وفقًا لمعيار IEEE 1003.1-1998.

NotSupportedException

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

DeleteEntry(TarEntry)

يُزيل أول ظهور لإدخال محدد من قائمة الإدخالات.

public TarArchive DeleteEntry(TarEntry entry)

المعلمات

entry TarEntry

الإدخال لإزالته من قائمة الإدخالات.

العائدات

TarArchive

الأرشيف مع الإدخال المحذوف.

أمثلة

إليك كيفية إزالة جميع الإدخالات باستثناء الأخيرة:

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(int)

يُزيل الإدخال من قائمة الإدخالات حسب الفهرس.

public TarArchive DeleteEntry(int entryIndex)

المعلمات

entryIndex int

الفهرس الصفري للإدخال لإزالته.

العائدات

TarArchive

الأرشيف مع الإدخال المحذوف.

أمثلة 

using (var archive = new TarArchive("two_files.tar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.tar");
}

الاستثناءات

ArgumentOutOfRangeException

entryIndex أقل من 0. - أو - entryIndex يساوي أو أكبر من عدد Entries.

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

المعلمات

disposing bool

ما إذا كان يجب التخلص من الموارد المُدارة.

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

المعلمات

destinationDirectory string

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

أمثلة 

using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

ملاحظات

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

الاستثناءات

ArgumentNullException

المسار هو null

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

المسار هو سلسلة بطول صفر، يحتوي فقط على مسافات بيضاء، أو يحتوي على حرف أو أكثر غير صالحة. يمكنك الاستعلام عن الأحرف غير الصالحة باستخدام طريقة System.IO.Path.GetInvalidPathChars. - أو - يتم تقديم المسار، أو يحتوي فقط على حرف نقطتين (:).

IOException

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

FromGZip(Stream)

يستخرج أرشيف gzip المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف gzip بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromGZip(Stream source)

المعلمات

source Stream

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

ملاحظات

تدفق استخراج GZip ليس قابلًا للبحث بطبيعة خوارزمية الضغط. يوفر أرشيف Tar إمكانية استخراج سجل عشوائي، لذا يجب أن يعمل على تدفق قابل للبحث تحت الغطاء.

الاستثناءات

InvalidDataException

الأرشيف تالف.

FromGZip(string)

يستخرج أرشيف gzip المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف gzip بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromGZip(string path)

المعلمات

path string

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

ملاحظات

تدفق استخراج GZip ليس قابلًا للبحث بطبيعة خوارزمية الضغط. يوفر أرشيف Tar إمكانية استخراج سجل عشوائي، لذا يجب أن يعمل على تدفق قابل للبحث تحت الغطاء.

الاستثناءات

InvalidDataException

الأرشيف تالف.

FromLZMA(Stream)

يستخرج أرشيف LZMA المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف LZMA بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromLZMA(Stream source)

المعلمات

source Stream

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

ملاحظات

تدفق استخراج LZMA ليس قابلًا للبحث بطبيعة خوارزمية الضغط. يوفر أرشيف Tar إمكانية استخراج سجل عشوائي، لذا يجب أن يعمل على تدفق قابل للبحث تحت الغطاء.

FromLZMA(string)

يستخرج أرشيف LZMA المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف LZMA بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromLZMA(string path)

المعلمات

path string

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

ملاحظات

تدفق استخراج LZMA ليس قابلًا للبحث بطبيعة خوارزمية الضغط. يوفر أرشيف Tar إمكانية استخراج سجل عشوائي، لذا يجب أن يعمل على تدفق قابل للبحث تحت الغطاء.

FromLZip(Stream)

يستخرج أرشيف lzip المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف lzip بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromLZip(Stream source)

المعلمات

source Stream

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

ملاحظات

تدفق استخراج lzip ليس قابلًا للبحث بطبيعة خوارزمية الضغط. يوفر أرشيف Tar إمكانية استخراج سجل عشوائي، لذا يجب أن يعمل على تدفق قابل للبحث تحت الغطاء.

FromLZip(string)

يستخرج أرشيف lzip المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف lzip بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromLZip(string path)

المعلمات

path string

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

ملاحظات

تدفق استخراج lzip ليس قابلًا للبحث بطبيعة خوارزمية الضغط. يوفر أرشيف Tar إمكانية استخراج سجل عشوائي، لذا يجب أن يعمل على تدفق قابل للبحث تحت الغطاء.

FromXz(Stream)

يستخرج أرشيف xz المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف xz بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromXz(Stream source)

المعلمات

source Stream

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

ملاحظات

يوفر أرشيف Tar إمكانية استخراج سجل عشوائي، لذا يجب أن يعمل على تدفق قابل للبحث تحت الغطاء.

FromXz(string)

يستخرج أرشيف xz المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف xz بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromXz(string path)

المعلمات

path string

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

ملاحظات

يوفر أرشيف Tar إمكانية استخراج سجل عشوائي، لذا يجب أن يعمل على تدفق قابل للبحث تحت الغطاء.

FromZ(Stream)

يستخرج أرشيف Z المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف Z بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromZ(Stream source)

المعلمات

source Stream

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

ملاحظات

يوفر أرشيف Tar إمكانية استخراج سجل عشوائي، لذا يجب أن يعمل على تدفق قابل للبحث تحت الغطاء.

FromZ(string)

يستخرج أرشيف Z المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف Z بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromZ(string path)

المعلمات

path string

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

ملاحظات

يوفر أرشيف Tar إمكانية استخراج سجل عشوائي، لذا يجب أن يعمل على تدفق قابل للبحث تحت الغطاء.

FromZstandard(Stream)

يستخرج أرشيف Zstandard المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف Zstandard بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromZstandard(Stream source)

المعلمات

source Stream

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

الاستثناءات

IOException

تدفق Zstandard تالف أو غير قابل للقراءة.

InvalidDataException

البيانات تالفة.

FromZstandard(string)

يستخرج أرشيف Zstandard المقدم ويكوّن Aspose.Zip.Tar.TarArchive من البيانات المستخرجة.

مهم: يتم استخراج أرشيف Zstandard بالكامل ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

public static TarArchive FromZstandard(string path)

المعلمات

path string

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

العائدات

TarArchive

مثيل من Aspose.Zip.Tar.TarArchive

الاستثناءات

IOException

تدفق Zstandard تالف أو غير قابل للقراءة.

InvalidDataException

البيانات تالفة.

Save(Stream, TarFormat?)

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

public void Save(Stream output, TarFormat? format = null)

المعلمات

output Stream

تدفق الوجهة.

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

ملاحظات

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

الاستثناءات

ArgumentException

output ليس قابلاً للكتابة. - أو - output هو نفس التدفق الذي نستخرج منه. - أو - من المستحيل حفظ الأرشيف في format بسبب قيود التنسيق.

Save(string, TarFormat?)

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

public void Save(string destinationFileName, TarFormat? format = null)

المعلمات

destinationFileName string

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

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

ملاحظات

من الممكن حفظ الأرشيف إلى نفس المسار الذي تم تحميله منه. ومع ذلك، لا يُوصى بذلك لأن هذه الطريقة تستخدم النسخ إلى ملف مؤقت.

الاستثناءات

ArgumentException

destinationFileName هو سلسلة بطول صفر، تحتوي فقط على مسافات بيضاء، أو تحتوي على حرف أو أكثر غير صالحة كما هو محدد بواسطة System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName هو null.

PathTooLongException

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

DirectoryNotFoundException

destinationFileName المحدد غير صالح، (على سبيل المثال، يكون على محرك غير مخصص).

IOException

حدث خطأ I/O أثناء فتح الملف.

UnauthorizedAccessException

destinationFileName حدد ملفًا للقراءة فقط والوصول ليس للقراءة. - أو - المسار المحدد هو دليل. - أو - لا يمتلك المتصل الإذن المطلوب.

NotSupportedException

destinationFileName في تنسيق غير صالح.

FileNotFoundException

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

SaveGzipped(Stream, TarFormat?)

يحفظ الأرشيف إلى التدفق مع ضغط gzip.

public void SaveGzipped(Stream output, TarFormat? format = null)

المعلمات

output Stream

تدفق الوجهة.

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream result = File.OpenWrite("result.tar.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

ملاحظات

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

الاستثناءات

ArgumentNullException

output هو null.

ArgumentException

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

SaveGzipped(string, TarFormat?)

يحفظ الأرشيف إلى الملف حسب المسار مع ضغط gzip.

public void SaveGzipped(string path, TarFormat? format = null)

المعلمات

path string

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

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.gz");
    }
}

SaveLZMACompressed(Stream, TarFormat?)

يحفظ الأرشيف إلى التدفق مع ضغط LZMA.

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

المعلمات

output Stream

تدفق الوجهة.

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

ملاحظات

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

مهم: يتم تكوين أرشيف tar ثم ضغطه ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

الاستثناءات

ArgumentNullException

output هو null.

ArgumentException

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

SaveLZMACompressed(string, TarFormat?)

يحفظ الأرشيف إلى الملف حسب المسار مع ضغط LZMA.

public void SaveLZMACompressed(string path, TarFormat? format = null)

المعلمات

path string

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

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.tar.lzma");
    }
}

ملاحظات

مهم: يتم تكوين أرشيف tar ثم ضغطه ضمن هذه الطريقة، ويتم الاحتفاظ بمحتواه داخليًا. احذر من استهلاك الذاكرة.

SaveLzipped(Stream, TarFormat?)

يحفظ الأرشيف إلى التدفق مع ضغط lzip.

public void SaveLzipped(Stream output, TarFormat? format = null)

المعلمات

output Stream

تدفق الوجهة.

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream result = File.OpenWrite("result.tar.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLzipped(result);
        }
    }
}

ملاحظات

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

الاستثناءات

ArgumentNullException

output هو null.

ArgumentException

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

SaveLzipped(string, TarFormat?)

يحفظ الأرشيف إلى الملف حسب المسار مع ضغط lzip.

public void SaveLzipped(string path, TarFormat? format = null)

المعلمات

path string

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

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.lz");
    }
}

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

يحفظ الأرشيف إلى التدفق مع ضغط xz.

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

المعلمات

output Stream

تدفق الوجهة.

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

settings XzArchiveSettings

مجموعة من الإعدادات الخاصة بأرشيف xz: حجم القاموس، حجم الكتلة، نوع التحقق.

أمثلة 

using (FileStream result = File.OpenWrite("result.tar.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

ملاحظات

يجب أن يكون output التدفق قابلاً للكتابة.

الاستثناءات

ArgumentNullException

output هو null.

ArgumentException

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

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

يحفظ الأرشيف إلى المسار حسب المسار مع ضغط xz.

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

المعلمات

path string

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

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

settings XzArchiveSettings

مجموعة من الإعدادات الخاصة بأرشيف xz: حجم القاموس، حجم الكتلة، نوع التحقق.

أمثلة 

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.tar.xz");
    }
}

SaveZCompressed(Stream, TarFormat?)

يحفظ الأرشيف إلى التدفق مع ضغط Z.

public void SaveZCompressed(Stream output, TarFormat? format = null)

المعلمات

output Stream

تدفق الوجهة.

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream result = File.OpenWrite("result.tar.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

ملاحظات

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

الاستثناءات

ArgumentNullException

output هو null.

ArgumentException

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

SaveZCompressed(string, TarFormat?)

يحفظ الأرشيف إلى المسار حسب المسار مع ضغط Z.

public void SaveZCompressed(string path, TarFormat? format = null)

المعلمات

path string

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

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.tar.Z");
    }
}

SaveZstandard(Stream, TarFormat?)

يحفظ الأرشيف إلى التدفق مع ضغط Zstandard.

public void SaveZstandard(Stream output, TarFormat? format = null)

المعلمات

output Stream

تدفق الوجهة.

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream result = File.OpenWrite("result.tar.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

ملاحظات

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

الاستثناءات

ArgumentNullException

output هو null.

ArgumentException

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

SaveZstandard(string, TarFormat?)

يحفظ الأرشيف إلى الملف حسب المسار مع ضغط Zstandard.

public void SaveZstandard(string path, TarFormat? format = null)

المعلمات

path string

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

format TarFormat?

يحدد تنسيق رأس tar. سيتم التعامل مع القيمة null كـ USTar عند الإمكان.

أمثلة 

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZstandard("result.tar.zst");
    }
}
 عربي