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 agrega al final del párrafo).
isAfterBooleanYa sea para 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 - Inserta 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 - Inserta un campo QUOTE antes de uno de los nodos secundarios del párrafo,
// y conseguir 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 agrega al final del párrafo).
isAfterBooleanYa sea para 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 - Inserta 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 - Inserta un campo QUOTE antes de uno de los nodos secundarios del párrafo,
// y conseguir 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. Aprobarnulo para campos que no tienen valor.
refNodeNodeNodo de referencia dentro de este párrafo (sirefNode esnulo, luego se agrega al final del párrafo).
isAfterBooleanYa sea para 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 - Inserta 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 - Inserta un campo QUOTE antes de uno de los nodos secundarios del párrafo,
// y conseguir 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