Trabajando con enlaces y referencias
Visión general
Los códigos de campo de enlace y referencia cruzada de Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, y más – se implementan cada una como una subclase dedicada Field subclase en Aspose.Words FOSS for .NET. Todas estas clases viven en el Aspose.Words.Fields namespace junto a todo tipo de campo; esta página agrupa las que están específicamente relacionadas con enlaces, referencias cruzadas, valores solicitados y citas, y describe lo que cada una expone.
Hyperlinks
FieldHyperlink representa el campo HYPERLINK: Address y SubAddress contienen la URL de destino o la ubicación dentro del documento, ScreenTip establece la información sobre el paso del ratón, OpenInNewWindow y IsImageMap son indicadores de visualización, y Target nombra un marco del navegador. En casos simples, DocumentBuilder.InsertHyperlink() inserta un campo de hipervínculo directamente sin construir el objeto Field manualmente.
Referencias cruzadas a marcadores
FieldRef (el campo REF), FieldPageRef (PAGEREF) y FieldNoteRef (NOTEREF) resuelven cada uno al contenido de un marcador con nombre mediante su propiedad BookmarkName, con InsertHyperlink y InsertRelativePosition controlando si la referencia es clickable y si informa una posición relativa (“arriba” / “abajo”). FieldRef añade opciones de numeración de párrafo (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) y IncludeNoteOrComment. FieldStyleRef (STYLEREF) en su lugar resuelve al párrafo más cercano formateado con un StyleName dado, con SearchFromBottom para buscar hacia atrás desde la posición del campo. Los marcadores que apuntan estos campos se crean con DocumentBuilder.StartBookmark() y EndBookmark(), y pueden navegarse con MoveToBookmark(). FieldSet (SET) define un valor de texto marcado — BookmarkName y BookmarkText — que un campo REF en otro lugar puede resolver.
Campos de valor solicitado
FieldAsk (ASK) y FieldFillIn (FILLIN) solicitan un valor a quien actualice el campo: PromptText se muestra al usuario, DefaultResponse provee una alternativa, y PromptOnceOnMailMerge limita los avisos repetidos durante una combinación de correspondencia. FieldAsk además almacena su respuesta en BookmarkName para que otros campos la referencien. Consulte el guía de campos for IFieldUserPromptRespondent, la devolución de llamada que suministra respuestas a estos campos de forma programática en lugar de solicitar interactivamente.
Contenido externo y vinculado
FieldDde (DDE) y FieldDdeAuto (DDEAUTO) enlazan a contenido en otra aplicación mediante ProgId, SourceFullName y SourceItem, con InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode y InsertAsBitmap seleccionando la representación insertada, y AutoUpdate / IsLinked controlando el comportamiento de actualización. FieldLink (LINK) es el equivalente OLE-link, añadiendo FormatUpdateType. FieldImport (IMPORT) y FieldIncludePicture (INCLUDEPICTURE) incorporan un gráfico externo mediante SourceFullName y GraphicFilter. FieldInclude (INCLUDE) y FieldIncludeText (INCLUDETEXT) incorporan contenido de documento externo, con BookmarkName para delimitar el rango incluido y LockFields para evitar que se actualice; FieldIncludeText también admite fuentes XML a través de Encoding, MimeType, NamespaceMappings, XPath y XslTransformation.
AutoText y referencias de glosario
FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) y FieldGlossary (GLOSSARY) hacen referencia a una entrada de bloque de construcción nombrada mediante EntryName; FieldAutoTextList añade ListStyle y ScreenTip para su presentación estilo lista.
Campos de citación y bibliografía
FieldCitation (CITATION) y FieldBibliography (BIBLIOGRAPHY) renderizar contenido procedente de los datos de bibliografía del documento. FieldCitation.SourceTag (y el alternativo AnotherSourceTag) identifica cuál fuente cita, con Prefix, Suffix, PageNumber, VolumeNumber, y el Suppress* banderas (SuppressAuthor, SuppressTitle, SuppressYear) que controla cómo se formatea la cita. FieldBibliography.SourceTag, FilterLanguageId, y FormatLanguageId controla qué fuentes aparecen en la bibliografía renderizada y en qué idioma. Los registros de origen subyacentes de estos campos renderizan – Source, Contributor, Person – están cubiertos en el guía de bibliografía.
Campos de texto de cita y forma
FieldQuote (QUOTE) y FieldShape (SHAPE) ambos exponen una propiedad Text que contiene texto literal del campo – FieldQuote lo inserta directamente en la posición del campo, mientras que FieldShape lo asocia al código de campo que lleva texto de una forma de dibujo.
Consejos y mejores prácticas
- Prefiere
DocumentBuilder.InsertHyperlink()para la inserción directa de hipervínculos; recurre a construir unFieldHyperlinkdirectamente solo cuando necesites propiedades comoScreenTipoIsImageMapque el atajo del generador no expone. FieldRef,FieldPageRef,FieldNoteRefyFieldSetse coordinan todos a través deBookmarkName– asegúrate de que el marcador de destino exista (a través deDocumentBuilder.StartBookmark()/EndBookmark()) antes de que se actualice el campo que lo referencia.- Conjunto
FieldOptions.UserPromptRespondent(vea la guía de campos) antes de actualizar un documento que contieneFieldAskorFieldFillIncampos en una canalización desatendida. FieldDdeyFieldDdeAutomodelan un mecanismo de enlace OLE heredado de Windows – trataAutoUpdateyIsLinkedcomo informativos al procesar documentos fuera de Windows, ya que la aplicación externa de la que normalmente se actualizarían no está disponible.- Los campos de cita y bibliografía solo se renderizan correctamente una vez que la base subyacente del documento
Sourceexisten registros – vea la guía de bibliografía para crearlos.
Problemas comunes
| Problema | Causa | Solución |
|---|---|---|
el campo REF / PAGEREF / NOTEREF muestra un resultado de error | El BookmarkName al que apunta no existe en el documento | Crea el marcador con DocumentBuilder.StartBookmark() / EndBookmark() antes de actualizar el campo |
El campo ASK / FILLIN bloquea una actualización no supervisada | No se ha asignado IFieldUserPromptRespondent | Asigna FieldOptions.UserPromptRespondent, o establece DefaultResponse en el campo |
El campo CITATION o BIBLIOGRAPHY se muestra vacío | El SourceTag no coincide con ningún Source en los datos de bibliografía del documento | Añade la coincidencia Source – ver el guía de bibliografía |
el campo DDE / DDEAUTO / LINK no se actualiza | Estas hacen referencia a una fuente externa OLE que no está disponible en el entorno actual | Se espera fuera del contexto original de Windows/OLE – trate el Result almacenado como el último valor conocido |
FAQ
¿Cuál es la diferencia entre FieldRef y FieldStyleRef?
FieldRef resuelve al contenido en un marcador nombrado (BookmarkName); FieldStyleRef en cambio resuelve al párrafo más cercano formateado con un StyleName dado, independiente de los marcadores.
¿Cómo inserto un hipervínculo simple sin crear un Field manualmente?
Llama a DocumentBuilder.InsertHyperlink().
¿Están estas clases de campos de enlace y referencia en un espacio de nombres separado de los demás campos?
No – FieldHyperlink, FieldRef, FieldCitation, y el resto de las clases en esta página son ordinarias Field subclases en el Aspose.Words.Fields espacio de nombres, el mismo espacio de nombres cubierto en el guía de campos.
¿Cómo se relacionan los campos de citación con el modelo de datos de la bibliografía?
FieldCitation and FieldBibliography renderizar contenido buscando SourceTag contra el Source registros descritos en el guía de bibliografía – las clases de campo manejan la renderización, y las Source / Contributor clases mantienen los datos subyacentes.
Resumen de API Reference
| Clase | Descripción |
|---|---|
FieldHyperlink | HYPERLINK campo; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF campos; resuelve contenido en un BookmarkName |
FieldStyleRef | STYLEREF campo; se resuelve al párrafo más cercano en un estilo dado |
FieldSet | SET campo; define un valor de texto marcado para REF a resolver |
FieldAsk / FieldFillIn | ASK / FILLIN campos; solicite un valor durante la actualización |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK campos; contenido externo vinculado mediante OLE heredado |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE campos; contenido gráfico externo |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT campos; documento externo o contenido XML |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY campos; entradas de bloques de construcción de referencia |
FieldCitation / FieldBibliography | campos CITATION / BIBLIOGRAPHY; renderizar datos de origen de la bibliografía |
FieldQuote / FieldShape | campos QUOTE / SHAPE; texto literal del campo |
DocumentBuilder.InsertHyperlink | Atajo de inserción de hipervínculo de alto nivel |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Creación y navegación de marcadores para objetivos de referencia |