InsertField

InsertField(FieldType, bool, Node, bool)

Inserisce un campo in questo paragrafo.

public Field InsertField(FieldType fieldType, bool updateField, Node refNode, bool isAfter)
ParametroTipoDescrizione
fieldTypeFieldTypeIl tipo di campo da inserire.
updateFieldBooleanSpecifica se aggiornare immediatamente il campo.
refNodeNodeNodo di riferimento all’interno di questo paragrafo (serefNode Ènull, quindi aggiunge alla fine del paragrafo).
isAfterBooleanSe inserire il campo dopo o prima del nodo di riferimento.

Valore di ritorno

UNField oggetto che rappresenta il campo inserito.

Esempi

Mostra vari modi per aggiungere campi a un paragrafo.

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

// Di seguito sono riportati tre modi per inserire un campo in un paragrafo.
// 1 - Inserire un campo AUTORE in un paragrafo dopo uno dei nodi figlio del paragrafo:
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 - Inserire un campo QUOTE dopo uno dei nodi figlio del paragrafo:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Inserire un campo QUOTE prima di uno dei nodi figlio del paragrafo,
// e fagli visualizzare un valore segnaposto:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Questo campo visualizzerà il suo valore segnaposto finché non lo aggiorneremo.
doc.UpdateFields();

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

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

Guarda anche


InsertField(string, Node, bool)

Inserisce un campo in questo paragrafo.

public Field InsertField(string fieldCode, Node refNode, bool isAfter)
ParametroTipoDescrizione
fieldCodeStringCodice di campo da inserire (senza parentesi graffe).
refNodeNodeNodo di riferimento all’interno di questo paragrafo (serefNode Ènull, quindi aggiunge alla fine del paragrafo).
isAfterBooleanSe inserire il campo dopo o prima del nodo di riferimento.

Valore di ritorno

UNField oggetto che rappresenta il campo inserito.

Esempi

Mostra vari modi per aggiungere campi a un paragrafo.

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

// Di seguito sono riportati tre modi per inserire un campo in un paragrafo.
// 1 - Inserire un campo AUTORE in un paragrafo dopo uno dei nodi figlio del paragrafo:
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 - Inserire un campo QUOTE dopo uno dei nodi figlio del paragrafo:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Inserire un campo QUOTE prima di uno dei nodi figlio del paragrafo,
// e fagli visualizzare un valore segnaposto:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Questo campo visualizzerà il suo valore segnaposto finché non lo aggiorneremo.
doc.UpdateFields();

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

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

Guarda anche


InsertField(string, string, Node, bool)

Inserisce un campo in questo paragrafo.

public Field InsertField(string fieldCode, string fieldValue, Node refNode, bool isAfter)
ParametroTipoDescrizione
fieldCodeStringCodice di campo da inserire (senza parentesi graffe).
fieldValueStringIl valore del campo da inserire. Passanull per i campi che non hanno un valore.
refNodeNodeNodo di riferimento all’interno di questo paragrafo (serefNode Ènull, quindi aggiunge alla fine del paragrafo).
isAfterBooleanSe inserire il campo dopo o prima del nodo di riferimento.

Valore di ritorno

UNField oggetto che rappresenta il campo inserito.

Esempi

Mostra vari modi per aggiungere campi a un paragrafo.

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

// Di seguito sono riportati tre modi per inserire un campo in un paragrafo.
// 1 - Inserire un campo AUTORE in un paragrafo dopo uno dei nodi figlio del paragrafo:
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 - Inserire un campo QUOTE dopo uno dei nodi figlio del paragrafo:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Inserire un campo QUOTE prima di uno dei nodi figlio del paragrafo,
// e fagli visualizzare un valore segnaposto:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Questo campo visualizzerà il suo valore segnaposto finché non lo aggiorneremo.
doc.UpdateFields();

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

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

Guarda anche