FieldFileName
محتويات
[
يخفي
]FieldFileName class
ينفذ حقل FILENAME.
لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.
public class FieldFileName : Field
المنشئون
| اسم | وصف |
|---|---|
| FieldFileName() | Default_Constructor |
الخصائص
| اسم | وصف |
|---|---|
| DisplayResult { get; } | يحصل على النص الذي يمثل نتيجة الحقل المعروضة. |
| End { get; } | يحصل على العقدة التي تمثل نهاية الحقل. |
| Format { get; } | يحصل علىFieldFormatالكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل. |
| IncludeFullPath { get; set; } | يحصل على أو يحدد ما إذا كان سيتم تضمين اسم مسار الملف الكامل. |
| IsDirty { get; set; } | يحصل على أو يحدد ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب التعديلات الأخرى التي تم إجراؤها على المستند. |
| IsLocked { get; set; } | يحصل على أو يحدد ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب نتيجته). |
| LocaleId { get; set; } | يحصل على أو يعين LCID للحقل. |
| Result { get; set; } | يحصل على النص الموجود بين فاصل الحقل ونهاية الحقل أو يعينه. |
| Separator { get; } | يحصل على العقدة التي تمثل فاصل الحقل. يمكن أن يكونباطل . |
| Start { get; } | يحصل على العقدة التي تمثل بداية الحقل. |
| virtual Type { get; } | يحصل على نوع حقل Microsoft Word. |
طُرق
| اسم | وصف |
|---|---|
| GetFieldCode() | يعيد النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية. |
| GetFieldCode(bool) | إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). |
| Remove() | يُزيل الحقل من المستند. يُرجع عقدة بعد الحقل مباشرةً. إذا كانت نهاية الحقل هي آخر عقدة فرعية للعقدة الأصلية، تُرجع فقرته الأصلية. إذا كان الحقل قد حُذف مُسبقًا، تُرجعباطل . |
| Unlink() | يقوم بإلغاء ربط الحقل. |
| Update() | يُجري تحديث الحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل. |
| Update(bool) | يُجري تحديثًا للحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل. |
ملاحظات
استرداد اسم المستند الحالي من موقع تخزينه.
في التنفيذ الحالي، يستخدمOriginalFileName خاصية لاسترجاع اسم الملف x000d_. إذا تم تحميل المستند من مصدر أو تم إنشاؤه فارغًا، فسيتم استخدام اسم الملف الذي سيتم حفظه (إن وجد).
أمثلة
يوضح كيفية استخدام FieldOptions لتجاوز القيمة الافتراضية لحقل FILENAME.
Document doc = new Document(MyDir + "Document.docx");
DocumentBuilder builder = new DocumentBuilder(doc);
builder.MoveToDocumentEnd();
builder.Writeln();
// سيعرض حقل FILENAME اسم ملف النظام المحلي للمستند الذي قمنا بتحميله.
FieldFileName field = (FieldFileName)builder.InsertField(FieldType.FieldFileName, true);
field.Update();
Assert.AreEqual(" FILENAME ", field.GetFieldCode());
Assert.AreEqual("Document.docx", field.Result);
builder.Writeln();
// بشكل افتراضي، يعرض حقل FILENAME اسم الملف، ولكن ليس مسار نظام الملفات المحلي الكامل.
//يمكننا تعيين علم لإظهار مسار الملف الكامل.
field = (FieldFileName)builder.InsertField(FieldType.FieldFileName, true);
field.IncludeFullPath = true;
field.Update();
Assert.AreEqual(MyDir + "Document.docx", field.Result);
// يمكننا أيضًا تعيين قيمة لهذه الخاصية إلى
// تجاوز القيمة التي يعرضها حقل اسم الملف.
doc.FieldOptions.FileName = "FieldOptions.FILENAME.docx";
field.Update();
Assert.AreEqual(" FILENAME \\p", field.GetFieldCode());
Assert.AreEqual("FieldOptions.FILENAME.docx", field.Result);
doc.UpdateFields();
doc.Save(ArtifactsDir + doc.FieldOptions.FileName);
أنظر أيضا
- class Field
- مساحة الاسم Aspose.Words.Fields
- المجسم Aspose.Words
