Insertar Campos
Hay varias formas diferentes de insertar campos en un documento:
- usando DocumentBuilder
- usando FieldBuilder
- usando Aspose.Words Modelo de objetos de documento (DOM)
En este artículo, veremos cada forma con más detalle y analizaremos cómo insertar ciertos campos usando estas opciones.
Insertar campos en un documento usando DocumentBuilder
En Aspose.Words, el método InsertField se usa para insertar nuevos campos en un documento. El primer parámetro acepta el código de campo completo del campo a insertar. El segundo parámetro es opcional y permite configurar manualmente el resultado del campo. Si no se proporciona, el campo se actualiza automáticamente. Puede pasar nulo o vacío a este parámetro para insertar un campo con un valor de campo vacío. Si no está seguro de la sintaxis del código de campo en particular, cree primero el campo en Microsoft Word y cambie para ver su código de campo.
El siguiente ejemplo de código muestra cómo insertar un campo de combinación en un documento usando DocumentBuilder:
Se utiliza la misma técnica para insertar campos anidados dentro de otros campos.
El siguiente ejemplo de código demuestra cómo insertar campos anidados dentro de otro campo usando DocumentBuilder:
Especifique la configuración regional a Nivel de Campo
Un identificador de idioma es una abreviatura numérica internacional estándar para el idioma en un país o región geográfica. Con Aspose.Words, puede especificar la configuración regional a nivel de campo utilizando la propiedad LocaleId, que obtiene o establece la configuración regional ID del campo.
El siguiente ejemplo de código muestra cómo usar esta opción:
Insertar Campo sin Tipo / Vacío
Si desea insertar campos sin tipo / vacíos ({}) tal como Microsoft Word lo permite, puede usar el método InsertField con el parámetro FieldType.FieldNone. Para insertar un campo en un documento de Word, puede presionar la combinación de teclas “Ctrl + F9”.
El siguiente ejemplo de código muestra cómo insertar un campo vacío en el documento:
Insertar COMPARE Campo
El campo COMPARE compara dos valores y devuelve el valor numérico 1 si la comparación es verdadera o 0 si la comparación es falsa.
El siguiente ejemplo de código muestra cómo agregar COMPARE campos usando DocumentBuilder:
Insertar IF Campo
El campo IF se puede utilizar para evaluar argumentos de forma condicional.
El siguiente ejemplo de código muestra cómo agregar IF campos usando DocumentBuilder:
Insertar campos en un documento usando FieldBuilder
La forma alternativa de insertar campos en Aspose.Words es la clase FieldBuilder. Proporciona una interfaz fluida para especificar modificadores de campo y valores de argumento como texto, nodos o incluso campos anidados.
El siguiente ejemplo de código muestra cómo insertar un campo en un documento usando FieldBuilder:
Insertar campos usando DOM
También puede insertar varios tipos de campos usando Aspose.Words Modelo de objetos de documento (DOM). En esta sección, veremos algunos ejemplos.
Insertar un campo de combinación en un documento usando DOM
MERGEFIELD field in Word document can be represented by the FieldMergeField class. You can use FieldMergeField class to perform the following operations:
- especifique el nombre del campo de combinación
- especifique el formato del campo de combinación
- especifique el texto que se encuentra entre el separador de campo y el final del campo del campo de combinación
- especifique el texto que se insertará después del campo de combinación si el campo no está en blanco
- especifique el texto que se insertará antes del campo de combinación si el campo no está en blanco
El siguiente ejemplo de código muestra cómo agregar el campo MERGE usando DOM a un párrafo de un documento:
Insertar el campo Mail Merge ADDRESSBLOCK en un documento usando DOM
El campo ADDRESSBLOCK se usa para insertar un bloque de direcciones Mail Merge en un documento de Word. El campo ADDRESSBLOCK en el documento de Word puede representarse mediante la clase FieldAddressBlock. Puede usar la clase FieldAddressBlock para realizar las siguientes operaciones:
- especifique si desea incluir el nombre del país / región en el campo
- especifique si desea formatear la dirección de acuerdo con el país/región del destinatario según lo definido por POST * CODE (Unión Postal Universal 2006)
- especifique el nombre del país/región excluido
- especifique el nombre y el formato de la dirección
- especifique el idioma ID utilizado para formatear la dirección
El siguiente ejemplo de código muestra cómo agregar el campo Mail Merge ADDRESSBLOCK usando DOM a un párrafo de un documento:
Insertar el campo ADVANCE en un documento sin usar DocumentBuilder
El campo ADVANCE se usa para desplazar el texto subsiguiente dentro de una línea hacia la izquierda, derecha, arriba o abajo. El campo ADVANCE en el documento de Word puede representarse mediante la clase FieldAdvance. Puede usar la clase FieldAdvance para realizar las siguientes operaciones:
- especifique el número de puntos en los que el texto que sigue al campo debe moverse verticalmente desde el borde superior de la página
- especifique el número de puntos en los que el texto que sigue al campo debe moverse horizontalmente desde el borde izquierdo de la columna, el marco o el cuadro de texto
- especifique el número de puntos en los que se debe mover el texto que sigue al campo hacia la izquierda, derecha, arriba o abajo.
El siguiente ejemplo de código muestra cómo agregar el campo ADVANCE usando DOM a un párrafo de un documento:
Insertar el campo ASK en un documento sin usar DocumentBuilder
El campo ASK se usa para solicitar al usuario texto para asignar a un marcador en un documento de Word. El campo ASK en el documento de Word puede representarse mediante la clase FieldAsk. Puede usar la clase FieldAsk para realizar las siguientes operaciones:
- especifique el nombre del marcador
- especifique la respuesta predeterminada del usuario (valor inicial contenido en la ventana de solicitud)
- especifique si la respuesta del usuario debe recibirse una vez por operación Mail Merge
- especifique el texto del mensaje (el título de la ventana del mensaje)
El siguiente ejemplo de código muestra cómo agregar el campo ASK usando DOM a un párrafo de un documento:
Insertar el campo AUTHOR en un documento sin usar DocumentBuilder
El campo AUTHOR se usa para especificar el nombre del autor del documento de las propiedades Document. El campo AUTHOR en el documento de Word puede representarse mediante la clase FieldAuthor. Puede usar la clase FieldAuthor para realizar las siguientes operaciones:
- especifique el nombre del autor del documento
El siguiente ejemplo de código muestra cómo agregar el campo AUTHOR usando DOM a un párrafo de un documento:
Insertar el campo INCLUDETEXT en un documento sin usar DocumentBuilder
El campo INCLUDETEXT inserta el texto y los gráficos contenidos en el documento nombrado en el código del campo. Puede insertar el documento completo o una parte del documento al que se hace referencia mediante un marcador. Este campo en el documento de Word está representado por INCLUDETEXT. Puede usar la clase FieldIncludeText para realizar las siguientes operaciones:
- especifique el nombre del marcador del documento incluido
- especifique la ubicación del documento
El siguiente ejemplo de código muestra cómo agregar el campo INCLUDETEXT usando DOM a un párrafo de un documento:
Insertar el campo TOA en un documento sin usar DocumentBuilder
El campo TOA (Table of Authorities) genera e inserta una tabla de autoridades. El campo TOA recopila entradas marcadas con campos TA (Table of Authorities Entry). Microsoft Office Word inserta el campo TOA cuando hace clic en Insert Table of Authorities en el grupo Table of Authorities en la pestaña References. Cuando ve el campo TOA en su documento, la sintaxis se ve así:
{ TOA [Switches ] }
El siguiente ejemplo de código muestra cómo agregar el campo TOA usando DOM a un párrafo de un documento.