InsertField

InsertField(FieldType, bool, Node, bool)

Inserta un campo en este párrafo.

public Field InsertField(FieldType fieldType, bool updateField, Node refNode, bool isAfter)
ParámetroEscribeDescripción
fieldTypeFieldTypeEl tipo de campo a insertar.
updateFieldBooleanEspecifica si se debe actualizar el campo inmediatamente.
refNodeNodeNodo de referencia dentro de este párrafo (sirefNode esnulo, luego se añade al final del párrafo).
isAfterBooleanSi insertar el campo después o antes del nodo de referencia.

Valor_devuelto

AField objeto que representa el campo insertado.

Ejemplos

Muestra varias formas de agregar campos a un párrafo.

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

// A continuación se muestran tres formas de insertar un campo en un párrafo.
// 1 - Inserta un campo AUTOR en un párrafo después de uno de los nodos secundarios del párrafo:
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 - Insertar un campo QUOTE después de uno de los nodos secundarios del párrafo:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Insertar un campo QUOTE antes de uno de los nodos secundarios del párrafo,
// y hacer que muestre un valor de marcador de posición:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Este campo mostrará su valor de marcador de posición hasta que lo actualicemos.
doc.UpdateFields();

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

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

Ver también


InsertField(string, Node, bool)

Inserta un campo en este párrafo.

public Field InsertField(string fieldCode, Node refNode, bool isAfter)
ParámetroEscribeDescripción
fieldCodeStringEl código de campo a insertar (sin llaves).
refNodeNodeNodo de referencia dentro de este párrafo (sirefNode esnulo, luego se añade al final del párrafo).
isAfterBooleanSi insertar el campo después o antes del nodo de referencia.

Valor_devuelto

AField objeto que representa el campo insertado.

Ejemplos

Muestra varias formas de agregar campos a un párrafo.

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

// A continuación se muestran tres formas de insertar un campo en un párrafo.
// 1 - Inserta un campo AUTOR en un párrafo después de uno de los nodos secundarios del párrafo:
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 - Insertar un campo QUOTE después de uno de los nodos secundarios del párrafo:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Insertar un campo QUOTE antes de uno de los nodos secundarios del párrafo,
// y hacer que muestre un valor de marcador de posición:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Este campo mostrará su valor de marcador de posición hasta que lo actualicemos.
doc.UpdateFields();

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

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

Ver también


InsertField(string, string, Node, bool)

Inserta un campo en este párrafo.

public Field InsertField(string fieldCode, string fieldValue, Node refNode, bool isAfter)
ParámetroEscribeDescripción
fieldCodeStringEl código de campo a insertar (sin llaves).
fieldValueStringEl valor del campo a insertar. Pasarnulo para campos que no tienen un valor.
refNodeNodeNodo de referencia dentro de este párrafo (sirefNode esnulo, luego se añade al final del párrafo).
isAfterBooleanSi insertar el campo después o antes del nodo de referencia.

Valor_devuelto

AField objeto que representa el campo insertado.

Ejemplos

Muestra varias formas de agregar campos a un párrafo.

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

// A continuación se muestran tres formas de insertar un campo en un párrafo.
// 1 - Inserta un campo AUTOR en un párrafo después de uno de los nodos secundarios del párrafo:
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 - Insertar un campo QUOTE después de uno de los nodos secundarios del párrafo:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

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

// 3 - Insertar un campo QUOTE antes de uno de los nodos secundarios del párrafo,
// y hacer que muestre un valor de marcador de posición:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Este campo mostrará su valor de marcador de posición hasta que lo actualicemos.
doc.UpdateFields();

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

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

Ver también