SharArchive.Save

Save(string)

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

public void Save(string destinationFileName)
معامليكتبوصف
destinationFileNameStringمسار الأرشيف المراد إنشاؤه. إذا كان اسم الملف المحدد يشير إلى ملف موجود ، فسيتم استبداله.

استثناءات

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

ملاحظات

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

أمثلة

using (var archive = new SharArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("archive.shar");
}

أنظر أيضا

Save(Stream)

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

public void Save(Stream output)
معامليكتبوصف
outputStreamتيار الوجهة.

استثناءات

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

ملاحظات

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

أمثلة

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(sharFile);
    }
}

أنظر أيضا

SharArchive.Dispose