Cómo trabajar con campos transitorios en .NET

Paso 1: Encontrar campos transicionales en un documento

Enumere Document.Range.Fields y compare el Type de cada campo (un valor FieldType) con las constantes relevantes — FieldBarcode, FieldDisplayBarcode, FieldMergeBarcode, FieldBidiOutline, FieldEQ, FieldFootnoteRef o FieldInfo — luego convierta el Field genérico a la clase coincidente para acceder a sus propiedades específicas. Siempre verifique Type antes de convertir: convertir a la clase de campo incorrecta lanza un InvalidCastException.

Paso 2: Configurar un campo DISPLAYBARCODE o MERGEBARCODE

FieldDisplayBarcode (el campo DISPLAYBARCODE) y FieldMergeBarcode (el campo MERGEBARCODE, que también implementa IMergeFieldSurrogate para combinación de correspondencia) comparten el mismo conjunto de propiedades de configuración de código de barras: BarcodeType, BarcodeValue, SymbolHeight, SymbolRotation, ScalingFactor, ForegroundColor, BackgroundColor, PosCodeStyle, CaseCodeStyle, ErrorCorrectionLevel, DisplayText, AddStartStopChar y FixCheckDigit. Establezca estas en la instancia del campo, luego llame a Update() para que Result refleje la nueva configuración antes de guardar el documento.

Paso 3: Leer datos del campo BARCODE (Postal) heredado

FieldBarcode implementa el campo BARCODE más antiguo, que es específicamente un campo de código de barras postal de EE. UU. (POSTNET) en lugar de un código de barras de propósito general — no comparte las propiedades BarcodeType/BarcodeValue del Paso 2. En su lugar expone PostalAddress (la dirección que codifica el código de barras), FacingIdentificationMark, IsUSPostalAddress y IsBookmark. Verifique Field.Type contra FieldType.FieldBarcode específicamente antes de leer estas propiedades, ya que convertir un campo DISPLAYBARCODE o MERGEBARCODE a FieldBarcode no expondría las propiedades que espera.

Paso 4: Renderizar imágenes de código de barras con un generador personalizado

Esta edición FOSS lleva datos de campo de código de barras pero no incluye un motor de renderizado de códigos de barras. BarcodeParameters es el contenedor de paso que consolida configuraciones de cualquiera de las familias de campos de código de barras — las propiedades DISPLAYBARCODE/MERGEBARCODE del Paso 2 y las propiedades postales del Paso 3 — en un solo objeto entregado a un renderizador. Implemente IBarcodeGenerator, exponiendo GetBarcodeImage(parameters) y el legado GetOldBarcodeImage(parameters), para proporcionar el renderizado real de la imagen; sin una implementación suministrada, los campos de código de barras solo transportan datos de configuración.

Paso 5: Trabajar con campos de compatibilidad heredados

Cuatro clases adicionales cubren códigos de campo más antiguos que aún se encuentran en archivos .docx heredados. FieldBidiOutline implementa el campo BIDIOUTLINE para numeración de contorno de derecha a izquierda y no expone propiedades más allá de la superficie común Field. FieldEQ implementa el campo de ecuación EQ y además expone AsOfficeMath() para convertir su contenido en un objeto OfficeMath — esto solo tiene éxito cuando el campo realmente codifica una ecuación. FieldFootnoteRef implementa el campo FOOTNOTEREF, que hace referencia cruzada a una marca de nota al pie o nota final, y también no expone propiedades más allá de la superficie común Field. FieldInfo implementa el campo INFO, leyendo o escribiendo una propiedad de resumen de información del documento a través de sus propiedades InfoType y NewValue.

Paso 6: Actualizar o congelar el valor de un campo transicional

Cada clase de campo transicional hereda GetFieldCode() (el texto subyacente del código del campo), Update() (recalcula el resultado), Unlink() (reemplaza el campo con su último resultado calculado como texto estático) y Remove() (elimina el campo). Llame a Update() después de cambiar la configuración de cualquier campo para que Result refleje el cambio, y use Unlink() cuando el valor actual de un campo debe congelarse en lugar de seguir siendo recalculable.