Class TarArchive

sourceStream’ is null.

`TarArchive(الستار)`

يبدأ حالة جديدة من فئة Aspose.Zip.Tar.tarArchive ويجمع قائمة إدخال يمكن استخراجها من الأرشيف.

public TarArchive(string path)

`Parameters`

path string

الطريق إلى ملف الأرشيف.

`Examples`

يظهر المثال التالي كيفية استخراج جميع الإدخالات إلى دليل.

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

`Remarks`

هذا المصنع لا يقطع أي إدخال. انظر Aspose.Zip.Tar.TarEntry.Open method for unpacking.

`Exceptions`

path’ is null.

لا يحصل المتصل على إذن الوصول المطلوب.

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

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

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

ملف في path’ يحتوي على عمود (:) في وسط السلسلة.

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

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

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

`Properties`

`Entries`

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

public ReadOnlyCollection<tarentry> Entries { get; }

`قيمة الممتلكات`

ReadOnlyCollection &lt؛ TarEntry >

`Methods`

`CreateEntries(أرشيف الوسم : Bool)`

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

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

`Parameters`

directory DirectoryInfo

فيديوهات متعلقة بـ Compress

includeRootDirectory bool

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

`Returns`

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

`Examples`

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(البول، البول)`

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

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

`Parameters`

sourceDirectory string

فيديوهات متعلقة بـ Compress

includeRootDirectory bool

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

`Returns`

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

`Examples`

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

`Exceptions`

sourceDirectory’ is null.

لا يتمتع المكالمة بالترخيص المطلوب للوصول إلى sourceDirectory'.

sourceDirectory’ contains invalid characters such as “, <, >, or |.

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

`CreateEntry(الأقراص، الأقراص، FileSystemInfo)`

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

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

`Parameters`

name string

اسم الدخول .

source Stream

تدفق الدخول للمدخل.

fileInfo FileSystemInfo

سيتم ضغط البيانات الميتا من الملف أو المجلد.

`Returns`

TarEntry

إرسال رسالة دخول

`Examples`

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

`Remarks`

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

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

`Exceptions`

name’ is too long for tar as of IEEE 1003.1-1998 standard.

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

`CreateEntry(أرشيف الوسم : FileInfo, Bool)`

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

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

`Parameters`

name string

اسم الدخول .

fileInfo FileInfo

سيتم ضغط البيانات الميتا من الملف أو المجلد.

openImmediately bool

صحيح، إذا قمت بفتح الملف على الفور، وإلا فتح الملف على حفظ الأرشيف.

`Returns`

TarEntry

إرسال رسالة دخول

`Examples`

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

`Remarks`

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

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

إذا تم فتح الملف على الفور مع المعيار فإنه يتم حظرها حتى يتم إزالة الأرشيف.

`Exceptions`

name’ is too long for tar as of IEEE 1003.1-1998 standard.

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

`CreateEntry(قوس قزح، قوس قزح)`

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

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

`Parameters`

name string

اسم الدخول .

path string

الطريق إلى التسجيل لتكون مضغوطة.

openImmediately bool

صحيح، إذا قمت بفتح الملف على الفور، وإلا فتح الملف على حفظ الأرشيف.

`Returns`

TarEntry

إرسال رسالة دخول

`Examples`

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

`Remarks`

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

إذا تم فتح الملف على الفور مع المعيار فإنه يتم حظرها حتى يتم إزالة الأرشيف.

`Exceptions`

path’ is null.

لا يحصل المتصل على إذن الوصول المطلوب.

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

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

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

ملف في path’ يحتوي على عمود (:) في وسط السلسلة.

`DeleteEntry(TarEntry)`

إزالة الحدث الأول من إدخال معين من قائمة الإدخال.

public TarArchive DeleteEntry(TarEntry entry)

`Parameters`

entry TarEntry

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

`Returns`

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

`Examples`

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

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

`DeleteEntry(إنت)`

إزالة الإدخال من قائمة الإدخال بواسطة المؤشر.

public TarArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

المؤشر القائم على الصفر من الدخول لإزالة.

`Returns`

ArgumentOutOfRangeException

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

`Examples`

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

`Exceptions`

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

`Dispose()`

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

public void Dispose()

`Dispose(بول)`

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

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

هل ينبغي تخصيص الموارد التي يتم إدارةها؟

`ExtractToDirectory(الستار)`

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

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

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

`Examples`

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

`Remarks`

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

`Exceptions`

الطريق صفر

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

لا يتمتع المكالمة بالترخيص المطلوب للوصول إلى الدليل الحالي.

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

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

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

`من جيب(Stream)`

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

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

public static TarArchive FromGZip(Stream source)

`Parameters`

source Stream

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

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

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

`Exceptions`

وقد تم تدمير الأرشيف

`من جيب(الستار)`

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

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

public static TarArchive FromGZip(string path)

`Parameters`

path string

الطريق إلى ملف الأرشيف.

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

`Exceptions`

path’ is null.

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

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

الملف في path" هو في تنسيق غير صالح.

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

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

وقد تم تدمير الأرشيف

`بواسطة LZ4(الستار)`

المستخلصات المقدمة LZ4 الأرشيف وتتكون Aspose.Zip.Tar.tarArchive من البيانات المستخرجة.

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

public static TarArchive FromLZ4(string path)

`Parameters`

path string

الطريق إلى ملف الأرشيف.

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

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

`Exceptions`

path’ is null.

لا يتمتع المستخدم بالترخيص المطلوب للوصول إلى

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

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

الملف في path" هو في تنسيق غير صالح.

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

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

EndOfStreamException

الملف قصير جداً.

الملف لديه التوقيع الخاطئ.

`بواسطة LZ4(Stream)`

المستخلصات المقدمة LZ4 الأرشيف وتتكون Aspose.Zip.Tar.tarArchive من البيانات المستخرجة.

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

public static TarArchive FromLZ4(Stream source)

`Parameters`

source Stream

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

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

`Exceptions`

لا يمكن قراءة من source’

source’ is null.

EndOfStreamException

source’ is too short.

يحتوي المصدر على التوقيع الخاطئ.

`من لزما(Stream)`

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

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

public static TarArchive FromLZMA(Stream source)

`Parameters`

source Stream

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

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

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

`Exceptions`

وقد تم تدمير الأرشيف

`من لزما(الستار)`

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

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

public static TarArchive FromLZMA(string path)

`Parameters`

path string

الطريق إلى ملف الأرشيف.

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

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

`Exceptions`

path’ is null.

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

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

الملف في path" هو في تنسيق غير صالح.

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

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

`من LZIP(Stream)`

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

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

public static TarArchive FromLZip(Stream source)

`Parameters`

source Stream

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

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

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

`Exceptions`

وقد تم تدمير الأرشيف

source’ is not seekable.

source’ is null.

`من LZIP(الستار)`

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

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

public static TarArchive FromLZip(string path)

`Parameters`

path string

الطريق إلى ملف الأرشيف.

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

`Exceptions`

path’ is null.

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

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

الملف في path" هو في تنسيق غير صالح.

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

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

وقد تم تدمير الأرشيف

`FromXz(Stream)`

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

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

public static TarArchive FromXz(Stream source)

`Parameters`

source Stream

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

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

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

`FromXz(الستار)`

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

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

public static TarArchive FromXz(string path)

`Parameters`

path string

الطريق إلى ملف الأرشيف.

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

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

`Exceptions`

path’ is null.

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

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

الملف في path" هو في تنسيق غير صالح.

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

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

`من ز(Stream)`

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

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

public static TarArchive FromZ(Stream source)

`Parameters`

source Stream

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

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

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

`من ز(الستار)`

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

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

public static TarArchive FromZ(string path)

`Parameters`

path string

الطريق إلى ملف الأرشيف.

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Remarks`

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

`Exceptions`

path’ is null.

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

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

الملف في path" هو في تنسيق غير صالح.

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

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

`FromZstandard(Stream)`

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

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

public static TarArchive FromZstandard(Stream source)

`Parameters`

source Stream

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

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Exceptions`

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

يتم تدمير البيانات.

`FromZstandard(الستار)`

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

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

public static TarArchive FromZstandard(string path)

`Parameters`

path string

الطريق إلى ملف الأرشيف.

`Returns`

فيديوهات متعلقة بـ “ Aspose.Zip.Tar.TarArchive

`Exceptions`

path’ is null.

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

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

الملف في path" هو في تنسيق غير صالح.

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

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

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

يتم تدمير البيانات.

`Save(تيرفورمات أو تيرفورمات؟)`

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

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

`Parameters`

output Stream

النطاق المستهدف

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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

`Remarks`

يجب أن تكون مكتوبة.

`Exceptions`

output’ is not writable. - or - output’ is the same stream we extract from.- OR -It is impossible to save archive in format’ due to format restrictions.

`Save(تيرفورت، تيرفورت؟)`

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

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

`Parameters`

destinationFileName string

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

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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

`Remarks`

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

`Exceptions`

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

destinationFileName’ is null.

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

المحدد destinationFileName’ غير صالح، (على سبيل المثال، هو على محرك أقراص غير مسجلة).

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

destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.

destinationFileName’ is in an invalid format.

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

`SaveGzipped(تيرفورمات أو تيرفورمات؟)`

توفير الأرشيف إلى التدفق باستخدام ضغط gzip.

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

`Parameters`

output Stream

النطاق المستهدف

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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);
        }
    }
}

`Remarks`

يجب أن تكون مكتوبة.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveGzipped(تيرفورت، تيرفورت؟)`

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

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

`Parameters`

path string

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

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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");
    }
}

`Exceptions`

لا يتمتع المكالمة بالترخيص المطلوب. -or- path" المحدد ملف أو دليل قراءة فقط.

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path’ is null.

الطريق المحدد " غير صالح، (على سبيل المثال، هو على محرك أقراص غير مسجلة).

path’ is in an invalid format.

`SaveLZ4مضغوطة(تيرفورمات أو تيرفورمات؟)`

توفير الأرشيف إلى التدفق مع ضغط LZ4.

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

`Parameters`

output Stream

النطاق المستهدف

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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

`Remarks`

يجب أن تكون مكتوبة.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveLZ4مضغوطة(تيرفورت، تيرفورت؟)`

تخزين الأرشيف إلى الملف عن طريق الطريق مع ضغط LZ4.

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

`Parameters`

path string

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

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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

`Exceptions`

لا يتمتع المكالمة بالترخيص المطلوب. -or- path" المحدد ملف أو دليل قراءة فقط.

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path’ is null.

الطريق المحدد " غير صالح، (على سبيل المثال، هو على محرك أقراص غير مسجلة).

path’ is in an invalid format.

`التخزين المضغوط(تيرفورمات أو تيرفورمات؟)`

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

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

`Parameters`

output Stream

النطاق المستهدف

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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);
        }
    }
}

`Remarks`

يجب أن تكون مكتوبة.

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

`Exceptions`

output’ is null.

output’ is not writable.

`التخزين المضغوط(تيرفورت، تيرفورت؟)`

تخزين الأرشيف إلى الملف عن طريق الطريق مع ضغط lzma.

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

`Parameters`

path string

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

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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");
    }
}

`Remarks`

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

`Exceptions`

لا يتمتع المكالمة بالترخيص المطلوب. -or- path" المحدد ملف أو دليل قراءة فقط.

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path’ is null.

الطريق المحدد " غير صالح، (على سبيل المثال، هو على محرك أقراص غير مسجلة).

path’ is in an invalid format.

`SaveLzipped(تيرفورمات أو تيرفورمات؟)`

تخزين الأرشيف إلى التدفق باستخدام ضغط lzip.

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

`Parameters`

output Stream

النطاق المستهدف

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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);
        }
    }
}

`Remarks`

يجب أن تكون مكتوبة.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveLzipped(تيرفورت، تيرفورت؟)`

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

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

`Parameters`

path string

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

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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");
    }
}

`Exceptions`

لا يتمتع المكالمة بالترخيص المطلوب. -or- path" المحدد ملف أو دليل قراءة فقط.

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path’ is null.

الطريق المحدد " غير صالح، (على سبيل المثال، هو على محرك أقراص غير مسجلة).

path’ is in an invalid format.

`SaveXzCompressed(Stream، TarFormat؟، XzArchiveSettings)`

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

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

`Parameters`

output Stream

النطاق المستهدف

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

settings XzArchiveSettings

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

`Examples`

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);
        }
    }
}

`Remarks`

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

`Exceptions`

output’ is null.

output’ is not writable.

`SaveXzCompressed(أضف تعليق حول: XzArchiveSettings)`

تخزين الأرشيف إلى الطريق عن طريق الطريق مع ضغط xz.

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

`Parameters`

path string

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

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

settings XzArchiveSettings

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

`Examples`

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");
    }
}

`Exceptions`

لا يتمتع المكالمة بالترخيص المطلوب. -or- path" المحدد ملف أو دليل قراءة فقط.

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path’ is null.

الطريق المحدد " غير صالح، (على سبيل المثال، هو على محرك أقراص غير مسجلة).

path’ is in an invalid format.

`أضف تعليق(تيرفورمات أو تيرفورمات؟)`

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

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

`Parameters`

output Stream

النطاق المستهدف

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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);
        }
    }
}

`Remarks`

يجب أن تكون مكتوبة.

`Exceptions`

output’ is null.

output’ is not writable.

`أضف تعليق(تيرفورت، تيرفورت؟)`

تخزين الأرشيف إلى المسار عن طريق الطريق مع ضغط Z.

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

`Parameters`

path string

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

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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");
    }
}

`Exceptions`

لا يتمتع المكالمة بالترخيص المطلوب. -or- path" المحدد ملف أو دليل قراءة فقط.

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path’ is null.

الطريق المحدد " غير صالح، (على سبيل المثال، هو على محرك أقراص غير مسجلة).

path’ is in an invalid format.

`SaveZstandard(تيرفورمات أو تيرفورمات؟)`

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

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

`Parameters`

output Stream

النطاق المستهدف

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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);
        }
    }
}

`Remarks`

يجب أن تكون مكتوبة.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveZstandard(تيرفورت، تيرفورت؟)`

تخزين الأرشيف إلى الملف عن طريق الطريق مع ضغط Zstandard.

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

`Parameters`

path string

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

format TarFormat ?

تحديد تنسيق العنوان التار.سيتم التعامل مع القيمة الصفرية باعتبارها USTar عندما يكون ذلك ممكنا.

`Examples`

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");
    }
}

`Exceptions`

لا يتمتع المكالمة بالترخيص المطلوب. -or- path" المحدد ملف أو دليل قراءة فقط.

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path’ is null.

الطريق المحدد " غير صالح، (على سبيل المثال، هو على محرك أقراص غير مسجلة).