TarArchive.Save

Save(Stream, TarFormat?)

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

public void Save(Stream output, TarFormat? format = default)
معامليكتبوصف
outputStreamتيار الوجهة.
formatNullable`1يحدد تنسيق رأس القطران. سيتم التعامل مع القيمة الفارغة على أنها USTar عندما يكون ذلك ممكنًا.

استثناءات

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

ملاحظات

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

أمثلة

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

أنظر أيضا


Save(string, TarFormat?)

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

public void Save(string destinationFileName, TarFormat? format = default)
معامليكتبوصف
destinationFileNameStringمسار الأرشيف المراد إنشاؤه. إذا كان اسم الملف المحدد يشير إلى ملف موجود ، فسيتم استبداله.
formatNullable`1يحدد تنسيق رأس القطران. سيتم التعامل مع القيمة الفارغة على أنها USTar عندما يكون ذلك ممكنًا.

استثناءات

استثناءحالة
ArgumentExceptiondestinationFileName عبارة عن سلسلة ذات طول صفري ، أو تحتوي على مسافة بيضاء فقط ، أو تحتوي على حرف واحد غير صالح أو أكثر كما هو محدد بواسطة System.IO.Path.InvalidPathChars.
ArgumentNullExceptiondestinationFileName باطل.
PathTooLongExceptionالمحددdestinationFileNameأو اسم الملف أو كلاهما يتجاوز الحد الأقصى للطول المحدد من قبل النظام. على سبيل المثال ، في الأنظمة الأساسية المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
DirectoryNotFoundExceptionالمحددdestinationFileName غير صالح (على سبيل المثال ، على محرك أقراص غير معين).
IOExceptionحدث خطأ I / O أثناء فتح الملف.
UnauthorizedAccessExceptiondestinationFileName حدد ملفًا للقراءة فقط وكان الوصول ليس للقراءة. أو - المسار المحدد دليلًا. - أو - ليس لدى المتصل الإذن المطلوب.
NotSupportedExceptiondestinationFileName بتنسيق غير صالح.

ملاحظات

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

أمثلة

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

أنظر أيضا