AppendField

AppendField(FieldType, bool)

Appends a field to this paragraph.

public Field AppendField(FieldType fieldType, bool updateField)

Parameter	Type	Description
fieldType	FieldType	The type of the field to append.
updateField	Boolean	Specifies whether to update the field immediately.

Return Value

A Field object that represents the appended field.

Examples

Shows various ways of appending fields to a paragraph.

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

// Below are three ways of appending a field to the end of a paragraph.
// 1 -  Append a DATE field using a field type, and then update it:
paragraph.AppendField(FieldType.FieldDate, true);

// 2 -  Append a TIME field using a field code: 
paragraph.AppendField(" TIME  \\@ \"HH:mm:ss\" ");

// 3 -  Append a QUOTE field using a field code, and get it to display a placeholder value:
paragraph.AppendField(" QUOTE \"Real value\"", "Placeholder value");

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

// This field will display its placeholder value until we update it.
doc.UpdateFields();

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

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

See Also

• class Field
• enum FieldType
• class Paragraph
• namespace Aspose.Words
• assembly Aspose.Words

---

AppendField(string)

Appends a field to this paragraph.

public Field AppendField(string fieldCode)

Parameter	Type	Description
fieldCode	String	The field code to append (without curly braces).

Return Value

A Field object that represents the appended field.

Examples

Shows various ways of appending fields to a paragraph.

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

// Below are three ways of appending a field to the end of a paragraph.
// 1 -  Append a DATE field using a field type, and then update it:
paragraph.AppendField(FieldType.FieldDate, true);

// 2 -  Append a TIME field using a field code: 
paragraph.AppendField(" TIME  \\@ \"HH:mm:ss\" ");

// 3 -  Append a QUOTE field using a field code, and get it to display a placeholder value:
paragraph.AppendField(" QUOTE \"Real value\"", "Placeholder value");

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

// This field will display its placeholder value until we update it.
doc.UpdateFields();

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

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

See Also

• class Field
• class Paragraph
• namespace Aspose.Words
• assembly Aspose.Words

---

AppendField(string, string)

Appends a field to this paragraph.

public Field AppendField(string fieldCode, string fieldValue)

Parameter	Type	Description
fieldCode	String	The field code to append (without curly braces).
fieldValue	String	The field value to append. Pass null for fields that do not have a value.

Return Value

A Field object that represents the appended field.

Examples

Shows various ways of appending fields to a paragraph.

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

// Below are three ways of appending a field to the end of a paragraph.
// 1 -  Append a DATE field using a field type, and then update it:
paragraph.AppendField(FieldType.FieldDate, true);

// 2 -  Append a TIME field using a field code: 
paragraph.AppendField(" TIME  \\@ \"HH:mm:ss\" ");

// 3 -  Append a QUOTE field using a field code, and get it to display a placeholder value:
paragraph.AppendField(" QUOTE \"Real value\"", "Placeholder value");

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

// This field will display its placeholder value until we update it.
doc.UpdateFields();

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

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

See Also

• class Field
• class Paragraph
• namespace Aspose.Words
• assembly Aspose.Words