TarArchive.CreateEntry

CreateEntry(string, Stream, FileSystemInfo)

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

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
معامليكتبوصف
nameStringاسم الإدخال.
sourceStreamتيار الإدخال للدخول.
fileInfoFileSystemInfoالبيانات الوصفية للملف أو المجلد المراد ضغطه.

قيمة الإرجاع

مثيل دخول القطران.

استثناءات

استثناءحالة
PathTooLongExceptionname طويل جدًا بالنسبة للقطران وفقًا لمعيار IEEE 1003.1-1998.
ArgumentExceptionاسم الملف كجزء منname، يتجاوز 100 رمز.

ملاحظات

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

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

أمثلة

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

أنظر أيضا


CreateEntry(string, FileInfo, bool)

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

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
معامليكتبوصف
nameStringاسم الإدخال.
fileInfoFileInfoالبيانات الوصفية للملف أو المجلد المراد ضغطه.
openImmediatelyBooleanصحيح إذا فتحت الملف على الفور ، وإلا فافتح الملف عند حفظ الأرشيف.

قيمة الإرجاع

مثيل دخول القطران.

استثناءات

استثناءحالة
PathTooLongExceptionname طويل جدًا بالنسبة للقطران وفقًا لمعيار IEEE 1003.1-1998.
ArgumentExceptionاسم الملف كجزء منname، يتجاوز 100 رمز.

ملاحظات

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

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

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

أمثلة

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

أنظر أيضا


CreateEntry(string, string, bool)

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

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
معامليكتبوصف
nameStringاسم الإدخال.
pathStringمسار الملف المراد ضغطه.
openImmediatelyBooleanصحيح إذا فتحت الملف على الفور ، وإلا فافتح الملف عند حفظ الأرشيف.

قيمة الإرجاع

مثيل دخول القطران.

استثناءات

استثناءحالة
ArgumentNullExceptionpath باطل.
SecurityExceptionالمتصل ليس لديه الإذن المطلوب للوصول.
ArgumentExceptionالpath فارغ أو يحتوي على مسافات بيضاء فقط أو يحتوي على أحرف غير صالحة. - أو - اسم الملف ، كجزء منname، يتجاوز 100 رمز.
UnauthorizedAccessExceptionالوصول إلى الملفpath مرفوض.
PathTooLongExceptionالمحددpath أو اسم الملف أو كلاهما يتجاوز الحد الأقصى للطول المحدد من قبل النظام. على سبيل المثال ، في الأنظمة الأساسية المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا. - أو -name طويل جدًا بالنسبة للقطران وفقًا لمعيار IEEE 1003.1-1998.
NotSupportedExceptionملف فيpath يحتوي على نقطتين (:) في منتصف السلسلة.

ملاحظات

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

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

أمثلة

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

أنظر أيضا