Trabajando con enlaces y referencias

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 un FieldHyperlink directamente solo cuando necesites propiedades como ScreenTip o IsImageMap que el atajo del generador no expone.
  • FieldRef, FieldPageRef, FieldNoteRef y FieldSet se coordinan todos a través de BookmarkName – asegúrate de que el marcador de destino exista (a través de DocumentBuilder.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 contiene FieldAsk or FieldFillIn campos en una canalización desatendida.
  • FieldDde y FieldDdeAuto modelan un mecanismo de enlace OLE heredado de Windows – trata AutoUpdate y IsLinked como 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 Source existen registros – vea la guía de bibliografía para crearlos.

Problemas comunes

ProblemaCausaSolución
el campo REF / PAGEREF / NOTEREF muestra un resultado de errorEl BookmarkName al que apunta no existe en el documentoCrea el marcador con DocumentBuilder.StartBookmark() / EndBookmark() antes de actualizar el campo
El campo ASK / FILLIN bloquea una actualización no supervisadaNo se ha asignado IFieldUserPromptRespondentAsigna FieldOptions.UserPromptRespondent, o establece DefaultResponse en el campo
El campo CITATION o BIBLIOGRAPHY se muestra vacíoEl SourceTag no coincide con ningún Source en los datos de bibliografía del documentoAñade la coincidencia Source – ver el guía de bibliografía
el campo DDE / DDEAUTO / LINK no se actualizaEstas hacen referencia a una fuente externa OLE que no está disponible en el entorno actualSe 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

ClaseDescripción
FieldHyperlinkHYPERLINK campo; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF campos; resuelve contenido en un BookmarkName
FieldStyleRefSTYLEREF campo; se resuelve al párrafo más cercano en un estilo dado
FieldSetSET campo; define un valor de texto marcado para REF a resolver
FieldAsk / FieldFillInASK / FILLIN campos; solicite un valor durante la actualización
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK campos; contenido externo vinculado mediante OLE heredado
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE campos; contenido gráfico externo
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT campos; documento externo o contenido XML
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY campos; entradas de bloques de construcción de referencia
FieldCitation / FieldBibliographycampos CITATION / BIBLIOGRAPHY; renderizar datos de origen de la bibliografía
FieldQuote / FieldShapecampos QUOTE / SHAPE; texto literal del campo
DocumentBuilder.InsertHyperlinkAtajo de inserción de hipervínculo de alto nivel
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkCreación y navegación de marcadores para objetivos de referencia

Ver también

 Español