FieldAutoNum

FieldAutoNum class

ينفذ الحقل AUTONUM.

لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.

public class FieldAutoNum : Field

المنشئون

اسموصف
FieldAutoNum()Default_Constructor

الخصائص

اسموصف
DisplayResult { get; }الحصول على النص الذي يمثل نتيجة الحقل المعروض.
End { get; }يحصل على العقدة التي تمثل نهاية الحقل.
Format { get; }يحصل علىFieldFormat الكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل.
IsDirty { get; set; }الحصول على أو تعيين ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب تعديلات أخرى تم إجراؤها على المستند.
IsLocked { get; set; }الحصول على أو تعيين ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب النتيجة).
LocaleId { get; set; }الحصول على أو تعيين LCID الخاص بالحقل.
Result { get; set; }الحصول على أو تعيين النص الموجود بين فاصل الحقل ونهاية الحقل.
Separator { get; }يحصل على العقدة التي تمثل فاصل الحقول. يمكن ان يكونباطل .
SeparatorCharacter { get; set; }الحصول على أو تعيين الحرف الفاصل المطلوب استخدامه.
Start { get; }يحصل على العقدة التي تمثل بداية الحقل.
virtual Type { get; }الحصول على نوع حقل Microsoft Word.

طُرق

اسموصف
GetFieldCode()إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية.
GetFieldCode(bool)إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل).
Remove()إزالة الحقل من المستند. إرجاع عقدة مباشرة بعد الحقل. إذا كانت نهاية الحقل هي الطفل الأخير للعقدة الأصلية، فسيتم إرجاع الفقرة الأصلية الخاصة به. إذا تمت إزالة الحقل بالفعل، فسيتم إرجاعهباطل .
Unlink()يقوم بإلغاء ربط الحقل.
Update()يقوم بإجراء التحديث الميداني. يتم الرمي إذا تم تحديث الحقل بالفعل.
Update(bool)إجراء تحديث ميداني. يتم الرمي إذا تم تحديث الحقل بالفعل.

ملاحظات

إدراج رقم تلقائي.

أمثلة

يوضح كيفية ترقيم الفقرات باستخدام الحقول التلقائية.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// يعرض كل حقل AUTONUM القيمة الحالية للعدد الجاري لحقول AUTONUM،
// السماح لنا بترقيم العناصر تلقائيًا مثل قائمة مرقمة.
// سيعرض هذا الحقل الرقم "1.".
FieldAutoNum field = (FieldAutoNum)builder.InsertField(FieldType.FieldAutoNum, true);
builder.Writeln("\tParagraph 1.");

Assert.AreEqual(" AUTONUM ", field.GetFieldCode());

field = (FieldAutoNum)builder.InsertField(FieldType.FieldAutoNum, true);
builder.Writeln("\tParagraph 2.");

// الحرف الفاصل، الذي يظهر في نتيجة الحقل مباشرة بعد الرقم، هو نقطة بشكل افتراضي.
// إذا تركنا هذه الخاصية فارغة، فسيعرض الحقل التلقائي الثاني لدينا "2." في الوثيقة.
Assert.IsNull(field.SeparatorCharacter);

// يمكننا ضبط هذه الخاصية لتطبيق الحرف الأول من السلسلة الخاصة بها كحرف فاصل جديد.
// في هذه الحالة، سيعرض حقل AUTONUM الخاص بنا الآن "2:".
field.SeparatorCharacter = ":";

Assert.AreEqual(" AUTONUM  \\s :", field.GetFieldCode());

doc.Save(ArtifactsDir + "Field.AUTONUM.docx");

أنظر أيضا