InsertField

InsertField(FieldType, bool)

يقوم بإدراج حقل Word في مستند ويقوم بتحديث نتيجة الحقل بشكل اختياري.

public Field InsertField(FieldType fieldType, bool updateField)

معامل	يكتب	وصف
fieldType	FieldType	نوع الحقل المراد إلحاقه.
updateField	Boolean	يحدد ما إذا كان سيتم تحديث الحقل على الفور.

قيمة الإرجاع

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

ملاحظات

تقوم هذه الطريقة بإدراج حقل في مستند. Aspose. يمكن للكلمات تحديث الحقول لمعظم الأنواع، ولكن ليس كلها. لمزيد من التفاصيل راجع the InsertField الزائد.

أمثلة

يوضح كيفية إدراج حقل في مستند باستخدام FieldType.

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

// أدخل حقلين أثناء تمرير علامة تحدد ما إذا كان سيتم تحديثهما عندما يقوم المنشئ بإدراجهما.
// في بعض الحالات، قد يكون تحديث الحقول مكلفًا من الناحية الحسابية، وقد يكون تأجيل التحديث فكرة جيدة.
doc.BuiltInDocumentProperties.Author = "John Doe";
builder.Write("This document was written by ");
builder.InsertField(FieldType.FieldAuthor, updateInsertedFieldsImmediately);

builder.InsertParagraph();
builder.Write("\nThis is page ");
builder.InsertField(FieldType.FieldPage, updateInsertedFieldsImmediately);

Assert.AreEqual(" AUTHOR ", doc.Range.Fields[0].GetFieldCode());
Assert.AreEqual(" PAGE ", doc.Range.Fields[1].GetFieldCode());

if (updateInsertedFieldsImmediately)
{
    Assert.AreEqual("John Doe", doc.Range.Fields[0].Result);
    Assert.AreEqual("1", doc.Range.Fields[1].Result);
}
else
{
    Assert.AreEqual(string.Empty, doc.Range.Fields[0].Result);
    Assert.AreEqual(string.Empty, doc.Range.Fields[1].Result);

    // سنحتاج إلى تحديث هذه الحقول باستخدام طرق التحديث يدويًا.
    doc.Range.Fields[0].Update();

    Assert.AreEqual("John Doe", doc.Range.Fields[0].Result);

    doc.UpdateFields();

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

أنظر أيضا

class Field
enum FieldType
class DocumentBuilder
مساحة الاسم Aspose.Words
المجسم Aspose.Words

InsertField(string)

إدراج حقل Word في المستند وتحديث نتيجة الحقل.

public Field InsertField(string fieldCode)

معامل	يكتب	وصف
fieldCode	String	رمز الحقل المراد إدراجه (بدون الأقواس المتعرجة).

قيمة الإرجاع

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

ملاحظات

تقوم هذه الطريقة بإدراج حقل في مستند وتحديث نتيجة الحقل على الفور. يمكن لـ Aspose.Words تحديث الحقول لمعظم الأنواع، ولكن ليس كلها. لمزيد من التفاصيل راجع the InsertField الزائد.

أمثلة

يوضح كيفية إدراج حقل في مستند باستخدام رمز الحقل.

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

Field field = builder.InsertField("DATE \\@ \"dddd, MMMM dd, yyyy\"");

Assert.AreEqual(FieldType.FieldDate, field.Type);
Assert.AreEqual("DATE \\@ \"dddd, MMMM dd, yyyy\"", field.GetFieldCode());

// هذا التحميل الزائد لطريقة InsertField يقوم تلقائيًا بتحديث الحقول المدرجة.
Assert.That(DateTime.Parse(field.Result), Is.EqualTo(DateTime.Today).Within(1).Days);

يوضح كيفية إدراج الحقول وتحريك مؤشر أداة إنشاء المستندات إليها.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertField(@"MERGEFIELD MyMergeField1 \* MERGEFORMAT");
builder.InsertField(@"MERGEFIELD MyMergeField2 \* MERGEFORMAT");

// حرك المؤشر إلى حقل MERGEFIELD الأول.
builder.MoveToMergeField("MyMergeField1", true, false);

// لاحظ أن المؤشر يتم وضعه مباشرة بعد حقل الدمج الأول وقبل الثاني.
Assert.AreEqual(doc.Range.Fields[1].Start, builder.CurrentNode);
Assert.AreEqual(doc.Range.Fields[0].End, builder.CurrentNode.PreviousSibling);

// إذا أردنا تعديل رمز الحقل أو محتوياته باستخدام المنشئ،
// يجب أن يكون المؤشر داخل الحقل.
// لوضعه داخل حقل، سنحتاج إلى استدعاء أسلوب MoveTo الخاص بمنشئ المستندات
// وتمرير بداية الحقل أو العقدة الفاصلة كوسيطة.
builder.Write(" Text between our merge fields. ");

doc.Save(ArtifactsDir + "DocumentBuilder.MergeFields.docx");

أنظر أيضا

class Field
class DocumentBuilder
مساحة الاسم Aspose.Words
المجسم Aspose.Words

InsertField(string, string)

إدراج حقل Word في مستند دون تحديث نتيجة الحقل.

public Field InsertField(string fieldCode, string fieldValue)

معامل	يكتب	وصف
fieldCode	String	رمز الحقل المراد إدراجه (بدون الأقواس المتعرجة).
fieldValue	String	قيمة الحقل المراد إدراجه. يمر`باطل` للحقول التي ليس لها قيمة.

قيمة الإرجاع

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

ملاحظات

تتكون الحقول في مستندات Microsoft Word من رمز الحقل ونتيجة الحقل. يشبه رمز الحقل الصيغة وتكون نتيجة الحقل مثل القيمة التي تنتجها الصيغة . قد يحتوي رمز الحقل أيضًا على مفاتيح الحقل التي تشبه الإرشادات الإضافية لتنفيذ إجراء معين.

يمكنك التبديل بين عرض رموز الحقول والنتائج في مستندك in Microsoft Word باستخدام اختصار لوحة المفاتيح Alt+F9. تظهر رموز الحقول بين الأقواس المتعرجة ( { } ).

لإنشاء حقل، تحتاج إلى تحديد نوع الحقل ورمز الحقل وقيمة حقل “العنصر النائب”. إذا لم تكن متأكدًا من بناء جملة رمز حقل معين، فقم بإنشاء الحقل في Microsoft Word first وقم بالتبديل لرؤية رمز الحقل الخاص به .

يمكن لـ Aspose.Words حساب نتائج الحقل لمعظم أنواع الحقول، لكن هذه الطريقة لا تقوم بتحديث نتيجة الحقل تلقائيًا. نظرًا لأن نتيجة الحقل لا يتم حسابها تلقائيًا، فمن المتوقع أن تمرر بعض قيم السلسلة (أو حتى سلسلة فارغة) التي سيتم إدراجها في نتيجة الحقل. ستبقى هذه القيمة في نتيجة الحقل كعنصر نائب حتى يتم إضافة الحقل update. لتحديث النتيجة الميدانية يمكنك الاتصالUpdateعلى الكائن الميداني return إليك أوUpdateFields لتحديث الحقول في المستند بأكمله.

أمثلة

يوضح كيفية إعداد ترقيم الصفحات في القسم.

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

builder.Writeln("Section 1, page 1.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Section 1, page 2.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Section 1, page 3.");
builder.InsertBreak(BreakType.SectionBreakNewPage);
builder.Writeln("Section 2, page 1.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Section 2, page 2.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Section 2, page 3.");

// انقل أداة إنشاء المستندات إلى الرأس الأساسي للقسم الأول،
// الذي ستعرضه كل صفحة في هذا القسم.
builder.MoveToSection(0);
builder.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);

// أدخل حقل الصفحة، والذي سيعرض رقم الصفحة الحالية.
builder.Write("Page ");
builder.InsertField("PAGE", "");

// قم بتكوين القسم بحيث يبدأ عدد الصفحات التي تعرضها حقول PAGE من 5.
// أيضًا، قم بتكوين كافة حقول PAGE لعرض أرقام الصفحات الخاصة بها باستخدام الأرقام الرومانية الكبيرة.
PageSetup pageSetup = doc.Sections[0].PageSetup;
pageSetup.RestartPageNumbering = true;
pageSetup.PageStartingNumber = 5;
pageSetup.PageNumberStyle = NumberStyle.UppercaseRoman;

// أنشئ رأسًا أساسيًا آخر للقسم الثاني، مع حقل PAGE آخر.
builder.MoveToSection(1);
builder.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;
builder.Write(" - ");
builder.InsertField("PAGE", "");
builder.Write(" - ");

// قم بتكوين القسم بحيث يبدأ عدد الصفحات التي تعرضها حقول PAGE من 10.
// أيضًا، قم بتكوين جميع حقول PAGE لعرض أرقام صفحاتها باستخدام الأرقام العربية.
pageSetup = doc.Sections[1].PageSetup;
pageSetup.PageStartingNumber = 10;
pageSetup.RestartPageNumbering = true;
pageSetup.PageNumberStyle = NumberStyle.Arabic;

doc.Save(ArtifactsDir + "PageSetup.PageNumbering.docx");

أنظر أيضا

class Field
class DocumentBuilder
مساحة الاسم Aspose.Words
المجسم Aspose.Words

DocumentBuilder.InsertDocument DocumentBuilder.InsertFootnote