Работа со ссылками и ссылками

Работа со ссылками и ссылками

Работа со ссылками и перекрёстными ссылками

Коды полей ссылок и перекрёстных ссылок в Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, и др. – реализованы как отдельные Field подкласс в Aspose.Words FOSS для .NET. Все эти классы находятся в Aspose.Words.Fields пространстве имён вместе со всеми другими типами полей; эта страница группирует те, которые специально относятся к ссылкам, перекрёстным ссылкам, запрашиваемым значениям и цитатам, и описывает, что каждый из них предоставляет.


Hyperlinks

FieldHyperlink представляет поле HYPERLINK: Address и SubAddress содержат целевой URL или местоположение внутри документа, ScreenTip задаёт всплывающую подсказку, OpenInNewWindow и IsImageMap являются флагами отображения, а Target задаёт имя фрейма браузера. Для простых случаев DocumentBuilder.InsertHyperlink() вставляет поле гиперссылки напрямую, не создавая объект Field вручную.


Перекрёстные ссылки на закладки

FieldRef (поле REF), FieldPageRef (PAGEREF) и FieldNoteRef (NOTEREF) каждый разрешают содержимое по именованной закладке через их свойство BookmarkName, при этом InsertHyperlink и InsertRelativePosition управляют тем, является ли ссылка кликабельной и сообщает ли она относительное положение («выше» / «ниже»). FieldRef добавляет варианты нумерации абзацев (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) и IncludeNoteOrComment. FieldStyleRef (STYLEREF) вместо этого разрешает ближайший абзац, отформатированный заданным StyleName, с SearchFromBottom для поиска назад от позиции поля. Закладки, к которым эти поля обращаются, создаются с помощью DocumentBuilder.StartBookmark() и EndBookmark(), и к ним можно перейти с помощью MoveToBookmark(). FieldSet (SET) определяет значение текста закладки — BookmarkName и BookmarkText — которое поле REF в другом месте может разрешить.


Поля запрашиваемых значений

FieldAsk (ASK) и FieldFillIn (FILLIN) запрашивает значение у того, кто обновляет поле: PromptText показывается пользователю, DefaultResponse предоставляет запасной вариант, и PromptOnceOnMailMerge ограничивает повторные подсказки во время слияния писем. FieldAsk дополнительно сохраняет свой ответ по адресу BookmarkName для ссылки другими полями. См. руководство по полям for IFieldUserPromptRespondent, обратный вызов, который программно предоставляет ответы этим полям вместо интерактивных запросов.


Внешний и связанный контент

FieldDde (DDE) и FieldDdeAuto (DDEAUTO) связываются с содержимым в другом приложении через ProgId, SourceFullName и SourceItem, при этом InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode и InsertAsBitmap выбирают вставляемое представление, а AutoUpdate / IsLinked управляют поведением обновления. FieldLink (LINK) является эквивалентом OLE-link, добавляя FormatUpdateType. FieldImport (IMPORT) и FieldIncludePicture (INCLUDEPICTURE) импортируют внешнюю графику через SourceFullName и GraphicFilter. FieldInclude (INCLUDE) и FieldIncludeText (INCLUDETEXT) импортируют внешнее содержимое документа, при этом BookmarkName задаёт диапазон включения, а LockFields предотвращает его обновление; FieldIncludeText дополнительно поддерживает источники XML через Encoding, MimeType, NamespaceMappings, XPath и XslTransformation.


AutoText и ссылки на глоссарий

FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) и FieldGlossary (GLOSSARY) все ссылаются на именованную запись строительного блока через EntryName; FieldAutoTextList добавляет ListStyle и ScreenTip для её представления в виде списка.


Поля цитирования и библиографии

FieldCitation (CITATION) и FieldBibliography (BIBLIOGRAPHY) отображать содержимое, полученное из данных библиографии документа. FieldCitation.SourceTag (и альтернативный AnotherSourceTag) определяет, какой источник он цитирует, с Prefix, Suffix, PageNumber, VolumeNumber, и Suppress* флаги (SuppressAuthor, SuppressTitle, SuppressYear) контролирующие, как форматируется цитата. FieldBibliography.SourceTag, FilterLanguageId, и FormatLanguageId контролируют, какие источники появляются в отрендеренной библиографии и на каком языке. Основной источник записывает эти поля рендеринга – Source, Contributor, Person – покрыты в руководство по библиографии.


Поля цитаты и формы текста

FieldQuote (QUOTE) и FieldShape (SHAPE) оба предоставляют свойство Text, содержащее буквальный текст поля – FieldQuote вставляет его непосредственно в позицию поля, тогда как FieldShape связывает его с полевым кодом текста в объекте рисунка.


Советы и лучшие практики

  • Предпочитайте DocumentBuilder.InsertHyperlink() для простого вставления гиперссылки; переходите к прямому построению FieldHyperlink только тогда, когда нужны свойства, такие как ScreenTip или IsImageMap, которые не доступны через быстрый конструктор.
  • FieldRef, FieldPageRef, FieldNoteRef и FieldSet все координируются через BookmarkName – убедитесь, что целевая закладка существует (через DocumentBuilder.StartBookmark() / EndBookmark()) до того, как обновляется поле, ссылающееся на неё.
  • Установить FieldOptions.UserPromptRespondent (см. руководство по полям) перед обновлением документа, содержащего FieldAsk or FieldFillIn поля в автоматическом конвейере.
  • FieldDde и FieldDdeAuto моделируют устаревший механизм связывания OLE в Windows – рассматривайте AutoUpdate и IsLinked как информационные при обработке документов вне Windows, поскольку внешнее приложение, из которого они обычно обновляются, недоступно.
  • Поля цитат и библиографии отображаются корректно только после того, как базовые Source записи существуют – см. руководство по библиографии для их создания.

Общие проблемы

ПроблемаПричинаИсправление
Поле REF / PAGEREF / NOTEREF показывает ошибочный результатОбъект BookmarkName, на который он ссылается, не существует в документеСоздайте закладку с DocumentBuilder.StartBookmark() / EndBookmark() перед обновлением поля
ASK / FILLIN поле блокирует автоматическое обновлениеНе назначено IFieldUserPromptRespondentНазначьте FieldOptions.UserPromptRespondent или установите DefaultResponse в поле
Поле CITATION или BIBLIOGRAPHY отображается пустымSourceTag не соответствует ни одному Source в библиографических данных документаДобавьте соответствующее Source – см. руководство по библиографии
DDE / DDEAUTO / LINK поле не обновляетсяЭти ссылки относятся к внешнему источнику OLE, который недоступен в текущей средеОжидается вне оригинального контекста Windows/OLE — рассматривайте сохранённый Result как последнее известное значение

FAQ

В чём разница между FieldRef и FieldStyleRef?

FieldRef соответствует содержимому в именованной закладке (BookmarkName); FieldStyleRef же соответствует ближайшему абзацу, отформатированному заданным StyleName, независимо от закладок.

Как вставить простую гиперссылку, не создавая Field вручную?

Вызовите DocumentBuilder.InsertHyperlink().

Являются ли эти классы полей link и reference в отдельном пространстве имён от других полей?

Нет – FieldHyperlink, FieldRef, FieldCitation, а остальные классы на этой странице являются обычными Field подклассы в Aspose.Words.Fields пространстве имён, том же пространстве имён, рассматриваемом в руководстве по полям.

Как поля цитирования соотносятся с моделью данных библиографии?

FieldCitation and FieldBibliography отображать контент, выполняя поиск SourceTag против Source записи, описанные в библиографический справочник – классы полей обрабатывают рендеринг, а Source / Contributor классы содержат базовые данные.


API Reference Сводка

КлассОписание:
FieldHyperlinkHYPERLINK поле; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF поля; разрешать содержимое в BookmarkName
FieldStyleRefSTYLEREF поле; разрешается к ближайшему абзацу в заданном стиле
FieldSetSET поле; определяет закладочное текстовое значение, которое REF может разрешить
FieldAsk / FieldFillInASK / FILLIN поля; запрос значения при обновлении
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK поля; устаревший внешний контент, привязанный OLE
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE поля; внешнее графическое содержание
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT поля; внешний документ или XML содержание
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY поля; записи справочных строительных блоков
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY поля; отображать исходные данные библиографии
FieldQuote / FieldShapeQUOTE / SHAPE поля; буквальный текст поля
DocumentBuilder.InsertHyperlinkСокращение для вставки гиперссылки высокого уровня
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkСоздание закладок и навигация к целевым объектам ссылки

См. также:

 Русский