InsertField

InsertField(FieldType, bool, Node, bool)

إدراج حقل في هذه الفقرة.

public Field InsertField(FieldType fieldType, bool updateField, Node refNode, bool isAfter)
معامليكتبوصف
fieldTypeFieldTypeنوع الحقل المراد إدراجه.
updateFieldBooleanيحدد ما إذا كان سيتم تحديث الحقل على الفور.
refNodeNodeالعقدة المرجعية داخل هذه الفقرة (ifrefNode يكونباطل، ثم يُلحق بنهاية الفقرة).
isAfterBooleanما إذا كان سيتم إدراج الحقل بعد العقدة المرجعية أو قبلها.

قيمة الإرجاع

أField كائن يمثل الحقل المدرج.

أمثلة

يعرض طرقًا مختلفة لإضافة الحقول إلى الفقرة.

Document doc = new Document();
Paragraph para = doc.FirstSection.Body.FirstParagraph;

// فيما يلي ثلاث طرق لإدراج حقل في فقرة.
// 1 - أدخل حقل المؤلف في فقرة بعد إحدى العقد الفرعية للفقرة:
Run run = new Run(doc) { Text = "This run was written by " };
para.AppendChild(run);

doc.BuiltInDocumentProperties["Author"].Value = "John Doe";
para.InsertField(FieldType.FieldAuthor, true, run, true);

// 2 - أدخل حقل اقتباس بعد إحدى العقد الفرعية للفقرة:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

Field field = para.InsertField(" QUOTE \" Real value\" ", run, true);

// 3 - أدخل حقل اقتباس قبل إحدى العقد الفرعية للفقرة،
// واحصل عليه لعرض قيمة العنصر النائب:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

Assert.AreEqual(" Placeholder value.", doc.Range.Fields[1].Result);

// سيعرض هذا الحقل قيمة العنصر النائب الخاص به حتى نقوم بتحديثه.
doc.UpdateFields();

Assert.AreEqual(" Real value.", doc.Range.Fields[1].Result);

doc.Save(ArtifactsDir + "Paragraph.InsertField.docx");

أنظر أيضا


InsertField(string, Node, bool)

إدراج حقل في هذه الفقرة.

public Field InsertField(string fieldCode, Node refNode, bool isAfter)
معامليكتبوصف
fieldCodeStringرمز الحقل المراد إدراجه (بدون الأقواس المتعرجة).
refNodeNodeالعقدة المرجعية داخل هذه الفقرة (ifrefNode يكونباطل، ثم يُلحق بنهاية الفقرة).
isAfterBooleanما إذا كان سيتم إدراج الحقل بعد العقدة المرجعية أو قبلها.

قيمة الإرجاع

أField كائن يمثل الحقل المدرج.

أمثلة

يعرض طرقًا مختلفة لإضافة الحقول إلى الفقرة.

Document doc = new Document();
Paragraph para = doc.FirstSection.Body.FirstParagraph;

// فيما يلي ثلاث طرق لإدراج حقل في فقرة.
// 1 - أدخل حقل المؤلف في فقرة بعد إحدى العقد الفرعية للفقرة:
Run run = new Run(doc) { Text = "This run was written by " };
para.AppendChild(run);

doc.BuiltInDocumentProperties["Author"].Value = "John Doe";
para.InsertField(FieldType.FieldAuthor, true, run, true);

// 2 - أدخل حقل اقتباس بعد إحدى العقد الفرعية للفقرة:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

Field field = para.InsertField(" QUOTE \" Real value\" ", run, true);

// 3 - أدخل حقل اقتباس قبل إحدى العقد الفرعية للفقرة،
// واحصل عليه لعرض قيمة العنصر النائب:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

Assert.AreEqual(" Placeholder value.", doc.Range.Fields[1].Result);

// سيعرض هذا الحقل قيمة العنصر النائب الخاص به حتى نقوم بتحديثه.
doc.UpdateFields();

Assert.AreEqual(" Real value.", doc.Range.Fields[1].Result);

doc.Save(ArtifactsDir + "Paragraph.InsertField.docx");

أنظر أيضا


InsertField(string, string, Node, bool)

إدراج حقل في هذه الفقرة.

public Field InsertField(string fieldCode, string fieldValue, Node refNode, bool isAfter)
معامليكتبوصف
fieldCodeStringرمز الحقل المراد إدراجه (بدون الأقواس المتعرجة).
fieldValueStringقيمة الحقل المراد إدراجه. يمرباطل للحقول التي ليس لها قيمة.
refNodeNodeالعقدة المرجعية داخل هذه الفقرة (ifrefNode يكونباطل، ثم يُلحق بنهاية الفقرة).
isAfterBooleanما إذا كان سيتم إدراج الحقل بعد العقدة المرجعية أو قبلها.

قيمة الإرجاع

أField كائن يمثل الحقل المدرج.

أمثلة

يعرض طرقًا مختلفة لإضافة الحقول إلى الفقرة.

Document doc = new Document();
Paragraph para = doc.FirstSection.Body.FirstParagraph;

// فيما يلي ثلاث طرق لإدراج حقل في فقرة.
// 1 - أدخل حقل المؤلف في فقرة بعد إحدى العقد الفرعية للفقرة:
Run run = new Run(doc) { Text = "This run was written by " };
para.AppendChild(run);

doc.BuiltInDocumentProperties["Author"].Value = "John Doe";
para.InsertField(FieldType.FieldAuthor, true, run, true);

// 2 - أدخل حقل اقتباس بعد إحدى العقد الفرعية للفقرة:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

Field field = para.InsertField(" QUOTE \" Real value\" ", run, true);

// 3 - أدخل حقل اقتباس قبل إحدى العقد الفرعية للفقرة،
// واحصل عليه لعرض قيمة العنصر النائب:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

Assert.AreEqual(" Placeholder value.", doc.Range.Fields[1].Result);

// سيعرض هذا الحقل قيمة العنصر النائب الخاص به حتى نقوم بتحديثه.
doc.UpdateFields();

Assert.AreEqual(" Real value.", doc.Range.Fields[1].Result);

doc.Save(ArtifactsDir + "Paragraph.InsertField.docx");

أنظر أيضا