InsertField

InsertField(FieldType, bool, Node, bool)

Fügt ein Feld in diesen Absatz ein.

public Field InsertField(FieldType fieldType, bool updateField, Node refNode, bool isAfter)
ParameterTypBeschreibung
fieldTypeFieldTypeDer Typ des einzufügenden Feldes.
updateFieldBooleanGibt an, ob das Feld sofort aktualisiert werden soll.
refNodeNodeReferenzknoten innerhalb dieses Absatzes (fallsrefNode IstNull, wird dann an das Ende des Absatzes angehängt).
isAfterBooleanOb das Feld nach oder vor dem Referenzknoten eingefügt werden soll.

Rückgabewert

AField Objekt, das das eingefügte Feld darstellt.

Beispiele

Zeigt verschiedene Möglichkeiten zum Hinzufügen von Feldern zu einem Absatz.

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

// Nachfolgend finden Sie drei Möglichkeiten, ein Feld in einen Absatz einzufügen.
// 1 – Fügen Sie ein AUTHOR-Feld in einen Absatz nach einem der untergeordneten Knoten des Absatzes ein:
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 – Fügen Sie ein QUOTE-Feld nach einem der untergeordneten Knoten des Absatzes ein:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 – Fügen Sie ein QUOTE-Feld vor einem der untergeordneten Knoten des Absatzes ein.
// und einen Platzhalterwert anzeigen lassen:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Dieses Feld zeigt seinen Platzhalterwert an, bis wir ihn aktualisieren.
doc.UpdateFields();

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

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

Siehe auch


InsertField(string, Node, bool)

Fügt ein Feld in diesen Absatz ein.

public Field InsertField(string fieldCode, Node refNode, bool isAfter)
ParameterTypBeschreibung
fieldCodeStringDer einzufügende Feldcode (ohne geschweifte Klammern).
refNodeNodeReferenzknoten innerhalb dieses Absatzes (fallsrefNode IstNull, wird dann an das Ende des Absatzes angehängt).
isAfterBooleanOb das Feld nach oder vor dem Referenzknoten eingefügt werden soll.

Rückgabewert

AField Objekt, das das eingefügte Feld darstellt.

Beispiele

Zeigt verschiedene Möglichkeiten zum Hinzufügen von Feldern zu einem Absatz.

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

// Nachfolgend finden Sie drei Möglichkeiten, ein Feld in einen Absatz einzufügen.
// 1 – Fügen Sie ein AUTHOR-Feld in einen Absatz nach einem der untergeordneten Knoten des Absatzes ein:
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 – Fügen Sie ein QUOTE-Feld nach einem der untergeordneten Knoten des Absatzes ein:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 – Fügen Sie ein QUOTE-Feld vor einem der untergeordneten Knoten des Absatzes ein.
// und einen Platzhalterwert anzeigen lassen:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Dieses Feld zeigt seinen Platzhalterwert an, bis wir ihn aktualisieren.
doc.UpdateFields();

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

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

Siehe auch


InsertField(string, string, Node, bool)

Fügt ein Feld in diesen Absatz ein.

public Field InsertField(string fieldCode, string fieldValue, Node refNode, bool isAfter)
ParameterTypBeschreibung
fieldCodeStringDer einzufügende Feldcode (ohne geschweifte Klammern).
fieldValueStringDer einzufügende Feldwert. PassierenNull für Felder, die keinen Wert haben.
refNodeNodeReferenzknoten innerhalb dieses Absatzes (fallsrefNode IstNull, wird dann an das Ende des Absatzes angehängt).
isAfterBooleanOb das Feld nach oder vor dem Referenzknoten eingefügt werden soll.

Rückgabewert

AField Objekt, das das eingefügte Feld darstellt.

Beispiele

Zeigt verschiedene Möglichkeiten zum Hinzufügen von Feldern zu einem Absatz.

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

// Nachfolgend finden Sie drei Möglichkeiten, ein Feld in einen Absatz einzufügen.
// 1 – Fügen Sie ein AUTHOR-Feld in einen Absatz nach einem der untergeordneten Knoten des Absatzes ein:
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 – Fügen Sie ein QUOTE-Feld nach einem der untergeordneten Knoten des Absatzes ein:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 – Fügen Sie ein QUOTE-Feld vor einem der untergeordneten Knoten des Absatzes ein.
// und einen Platzhalterwert anzeigen lassen:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Dieses Feld zeigt seinen Platzhalterwert an, bis wir ihn aktualisieren.
doc.UpdateFields();

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

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

Siehe auch