InsertField

InsertField(FieldType, bool, Node, bool)

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

public Field InsertField(FieldType fieldType, bool updateField, Node refNode, bool isAfter)
معامليكتبوصف
fieldTypeFieldTypeنوع الحقل الذي سيتم إدراجه.
updateFieldBooleanيحدد ما إذا كان سيتم تحديث الحقل على الفور.
refNodeNodeعقدة مرجعية داخل هذه الفقرة (إذاrefNode يكونباطل(ثم يضاف إلى نهاية الفقرة).
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عقدة مرجعية داخل هذه الفقرة (إذاrefNode يكونباطل(ثم يضاف إلى نهاية الفقرة).
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عقدة مرجعية داخل هذه الفقرة (إذاrefNode يكونباطل(ثم يضاف إلى نهاية الفقرة).
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");

أنظر أيضا