Reemplazar campos con texto estatico
Reemplazar campos se requiere a menudo cuando desea guardar su documento como una copia estática. Por ejemplo, cuando se envía como adjunto en un correo electrónico. Convertir campos como DATE o TIME a texto estático permitirá que el documento muestre la misma fecha que cuando fue enviado. Además, en algunas situaciones, es posible que necesite eliminar el condicional IF campos de su documento y reemplazarlos con el resultado de texto más reciente en su lugar. Por ejemplo, convertir el resultado del IF campo a texto estático para que ya no cambie dinámicamente su valor cuando se actualizan los campos del documento.
El diagrama de abajo muestra cómo IF campo se almacena en un documento:
- el texto está rodeado por los nodos especiales de campo – FieldStart y FieldEnd
- FieldSeparator nodo separa el texto dentro del campo en el código de campo y resultado de campo
- el código de campo define el comportamiento general del campo, mientras que el resultado de campo conserva el resultado más reciente cuando este campo se actualiza utilizando Microsoft Word o Aspose.Words
- el resultado de campo es lo que se almacena en el campo y se muestra en el documento cuando se ve
La estructura también se puede ver abajo en forma jerárquica utilizando el proyecto demo “DocumentExplorer”, que nave con Aspose.Words instalador.
Campos que no pueden ser reemplazados por texto
Reemplazar un campo con texto estático no funciona correctamente para algunos campos en un encabezado o un pie de página.
Por ejemplo, tratando de convertir el PAGE campo en un encabezado o un pie a texto estático resultará en el mismo valor que se muestra en todas las páginas. Esto se debe a que los encabezados y los pies se repiten a través de múltiples páginas, y cuando permanecen como campos, se manejan especialmente para que muestren el resultado correcto para cada página.
Sin embargo, en el encabezado, el PAGE el campo traduce bien a la ejecución estática del texto. Esta ejecución de texto será evaluada como si fuera la última página de la sección, que causará cualquier PAGE campo en el encabezado para mostrar la última página en todas las páginas.
El siguiente ejemplo de código muestra cómo reemplazar el campo con su resultado más reciente:
Convertir ciertos tipos de campo en piezas específicas de documentos
Desde ConvertFieldsToStaticText método acepta dos parámetros – el CompositeNode propiedades y FieldType enumeración, es posible pasar cualquier nodo compuesto a este método. Esto permite que los campos se conviertan a texto estático sólo en partes específicas del documento.
Por ejemplo, puede pasar un Document objeto y convertir campos del tipo especificado de todo el documento a texto estático, o puede pasar un Body objeto de una sección y sólo convertir los campos encontrados en ese cuerpo.
El FieldType enumeration passed to the ConvertFieldsToStaticText método especifica qué tipo de campos debe ser convertido a texto estático. Cualquier otro tipo de campo encontrado en el documento permanecerá sin cambios.
El siguiente ejemplo de código muestra cómo seleccionar campos de un tipo específico – targetFieldType en un nodo específico – compositeNode y luego convertirlos en texto estático:
El siguiente ejemplo de código muestra cómo convertir todo IF campos en un documento a texto estático:
El siguiente ejemplo de código muestra cómo convertir todo PAGE campos en un Cuerpo de un documento a texto estático:
El siguiente ejemplo de código muestra cómo convertir todo IF campos del último párrafo al texto estático: