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.
refNodeNodeVerweisknoten 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;

// Unten sind drei Möglichkeiten zum Einfügen eines Felds in einen Absatz aufgeführt.
// 1 – Fügen Sie ein AUTOR-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 nach einem der untergeordneten Knoten des Absatzes ein QUOTE-Feld ein:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Fügen Sie vor einem der untergeordneten Knoten des Absatzes ein QUOTE-Feld ein.
// und lasse es einen Platzhalterwert anzeigen:
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 es 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).
refNodeNodeVerweisknoten 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;

// Unten sind drei Möglichkeiten zum Einfügen eines Felds in einen Absatz aufgeführt.
// 1 – Fügen Sie ein AUTOR-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 nach einem der untergeordneten Knoten des Absatzes ein QUOTE-Feld ein:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Fügen Sie vor einem der untergeordneten Knoten des Absatzes ein QUOTE-Feld ein.
// und lasse es einen Platzhalterwert anzeigen:
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 es 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.null für Felder, die keinen Wert haben.
refNodeNodeVerweisknoten 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;

// Unten sind drei Möglichkeiten zum Einfügen eines Felds in einen Absatz aufgeführt.
// 1 – Fügen Sie ein AUTOR-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 nach einem der untergeordneten Knoten des Absatzes ein QUOTE-Feld ein:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Fügen Sie vor einem der untergeordneten Knoten des Absatzes ein QUOTE-Feld ein.
// und lasse es einen Platzhalterwert anzeigen:
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 es aktualisieren.
doc.UpdateFields();

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

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

Siehe auch