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 Ènullo, quindi si 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 - Inserisci un campo AUTORE in un paragrafo dopo uno dei nodi figli 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 - Inserisci un campo QUOTE dopo uno dei nodi figli del paragrafo:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Inserisci un campo QUOTE prima di uno dei nodi figli del paragrafo,
// e faccio in modo che visualizzi un valore segnaposto:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Questo campo mostrerà 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
fieldCodeStringIl codice di campo da inserire (senza parentesi graffe).
refNodeNodeNodo di riferimento all’interno di questo paragrafo (serefNode Ènullo, quindi si 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 - Inserisci un campo AUTORE in un paragrafo dopo uno dei nodi figli 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 - Inserisci un campo QUOTE dopo uno dei nodi figli del paragrafo:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Inserisci un campo QUOTE prima di uno dei nodi figli del paragrafo,
// e faccio in modo che visualizzi un valore segnaposto:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Questo campo mostrerà 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
fieldCodeStringIl codice di campo da inserire (senza parentesi graffe).
fieldValueStringIl valore del campo da inserire. Passaggionullo per i campi che non hanno un valore.
refNodeNodeNodo di riferimento all’interno di questo paragrafo (serefNode Ènullo, quindi si 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 - Inserisci un campo AUTORE in un paragrafo dopo uno dei nodi figli 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 - Inserisci un campo QUOTE dopo uno dei nodi figli del paragrafo:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Inserisci un campo QUOTE prima di uno dei nodi figli del paragrafo,
// e faccio in modo che visualizzi un valore segnaposto:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Questo campo mostrerà 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