InsertField

InsertField(FieldType, bool, Node, bool)

Insère un champ dans ce paragraphe.

public Field InsertField(FieldType fieldType, bool updateField, Node refNode, bool isAfter)
ParamètreTaperLa description
fieldTypeFieldTypeLe type du champ à insérer.
updateFieldBooleanSpécifie s’il faut mettre à jour le champ immédiatement.
refNodeNodeNoeud de référence à l’intérieur de ce paragraphe (sirefNode estnul, puis ajouté à la fin du paragraphe).
isAfterBooleanS’il faut insérer le champ après ou avant le nœud de référence.

Return_Value

UNField objet qui représente le champ inséré.

Exemples

Montre différentes manières d’ajouter des champs à un paragraphe.

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

// Vous trouverez ci-dessous trois manières d'insérer un champ dans un paragraphe.
// 1 - Insère un champ AUTEUR dans un paragraphe après l'un des nœuds enfants du paragraphe :
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 - Insérer un champ QUOTE après l'un des nœuds enfants du paragraphe :
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Insérer un champ QUOTE avant un des nœuds enfants du paragraphe,
// et lui faire afficher une valeur d'espace réservé :
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Ce champ affichera sa valeur d'espace réservé jusqu'à ce que nous le mettions à jour.
doc.UpdateFields();

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

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

Voir également


InsertField(string, Node, bool)

Insère un champ dans ce paragraphe.

public Field InsertField(string fieldCode, Node refNode, bool isAfter)
ParamètreTaperLa description
fieldCodeStringLe code du champ à insérer (sans accolades).
refNodeNodeNoeud de référence à l’intérieur de ce paragraphe (sirefNode estnul, puis ajouté à la fin du paragraphe).
isAfterBooleanS’il faut insérer le champ après ou avant le nœud de référence.

Return_Value

UNField objet qui représente le champ inséré.

Exemples

Montre différentes manières d’ajouter des champs à un paragraphe.

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

// Vous trouverez ci-dessous trois manières d'insérer un champ dans un paragraphe.
// 1 - Insère un champ AUTEUR dans un paragraphe après l'un des nœuds enfants du paragraphe :
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 - Insérer un champ QUOTE après l'un des nœuds enfants du paragraphe :
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Insérer un champ QUOTE avant un des nœuds enfants du paragraphe,
// et lui faire afficher une valeur d'espace réservé :
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Ce champ affichera sa valeur d'espace réservé jusqu'à ce que nous le mettions à jour.
doc.UpdateFields();

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

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

Voir également


InsertField(string, string, Node, bool)

Insère un champ dans ce paragraphe.

public Field InsertField(string fieldCode, string fieldValue, Node refNode, bool isAfter)
ParamètreTaperLa description
fieldCodeStringLe code du champ à insérer (sans accolades).
fieldValueStringLa valeur du champ à insérer. Passernul pour les champs qui n’ont pas de valeur.
refNodeNodeNoeud de référence à l’intérieur de ce paragraphe (sirefNode estnul, puis ajouté à la fin du paragraphe).
isAfterBooleanS’il faut insérer le champ après ou avant le nœud de référence.

Return_Value

UNField objet qui représente le champ inséré.

Exemples

Montre différentes manières d’ajouter des champs à un paragraphe.

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

// Vous trouverez ci-dessous trois manières d'insérer un champ dans un paragraphe.
// 1 - Insère un champ AUTEUR dans un paragraphe après l'un des nœuds enfants du paragraphe :
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 - Insérer un champ QUOTE après l'un des nœuds enfants du paragraphe :
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Insérer un champ QUOTE avant un des nœuds enfants du paragraphe,
// et lui faire afficher une valeur d'espace réservé :
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Ce champ affichera sa valeur d'espace réservé jusqu'à ce que nous le mettions à jour.
doc.UpdateFields();

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

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

Voir également