TarArchive.Save
محتويات
[
يخفي
]Save(Stream, TarFormat?)
يحفظ الأرشيف إلى الدفق المقدم.
public void Save(Stream output, TarFormat? format = default)
معامل | يكتب | وصف |
---|---|---|
output | Stream | تيار الوجهة. |
format | Nullable`1 | يحدد تنسيق رأس القطران. سيتم التعامل مع القيمة الفارغة على أنها USTar عندما يكون ذلك ممكنًا. |
استثناءات
استثناء | حالة |
---|---|
ArgumentException | output غير قابل للكتابة. - أو -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);
}
}
أنظر أيضا
- enum TarFormat
- class TarArchive
- مساحة الاسم Aspose.Zip.Tar
- المجسم Aspose.Zip
Save(string, TarFormat?)
لحفظ الأرشيف في ملف الوجهة المقدم.
public void Save(string destinationFileName, TarFormat? format = default)
معامل | يكتب | وصف |
---|---|---|
destinationFileName | String | مسار الأرشيف المراد إنشاؤه. إذا كان اسم الملف المحدد يشير إلى ملف موجود ، فسيتم استبداله. |
format | Nullable`1 | يحدد تنسيق رأس القطران. سيتم التعامل مع القيمة الفارغة على أنها USTar عندما يكون ذلك ممكنًا. |
استثناءات
استثناء | حالة |
---|---|
ArgumentException | destinationFileName عبارة عن سلسلة ذات طول صفري ، أو تحتوي على مسافة بيضاء فقط ، أو تحتوي على حرف واحد غير صالح أو أكثر كما هو محدد بواسطة System.IO.Path.InvalidPathChars. |
ArgumentNullException | destinationFileName باطل. |
PathTooLongException | المحددdestinationFileNameأو اسم الملف أو كلاهما يتجاوز الحد الأقصى للطول المحدد من قبل النظام. على سبيل المثال ، في الأنظمة الأساسية المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا. |
DirectoryNotFoundException | المحددdestinationFileName غير صالح (على سبيل المثال ، على محرك أقراص غير معين). |
IOException | حدث خطأ I / O أثناء فتح الملف. |
UnauthorizedAccessException | destinationFileName حدد ملفًا للقراءة فقط وكان الوصول ليس للقراءة. أو - المسار المحدد دليلًا. - أو - ليس لدى المتصل الإذن المطلوب. |
NotSupportedException | destinationFileName بتنسيق غير صالح. |
ملاحظات
من الممكن حفظ أرشيف بنفس المسار الذي تم تحميله منه . ومع ذلك ، لا ينصح بهذا لأن هذا الأسلوب يستخدم النسخ إلى ملف مؤقت.
أمثلة
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("myarchive.tar");
}
أنظر أيضا
- enum TarFormat
- class TarArchive
- مساحة الاسم Aspose.Zip.Tar
- المجسم Aspose.Zip