Работа со ссылками и ссылками
Работа со ссылками и перекрёстными ссылками
Коды полей ссылок и перекрёстных ссылок в 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(см. руководство по полям) перед обновлением документа, содержащегоFieldAskorFieldFillInполя в автоматическом конвейере. 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 Сводка
| Класс | Описание: |
|---|---|
FieldHyperlink | HYPERLINK поле; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF поля; разрешать содержимое в BookmarkName |
FieldStyleRef | STYLEREF поле; разрешается к ближайшему абзацу в заданном стиле |
FieldSet | SET поле; определяет закладочное текстовое значение, которое REF может разрешить |
FieldAsk / FieldFillIn | ASK / FILLIN поля; запрос значения при обновлении |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK поля; устаревший внешний контент, привязанный OLE |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE поля; внешнее графическое содержание |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT поля; внешний документ или XML содержание |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY поля; записи справочных строительных блоков |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY поля; отображать исходные данные библиографии |
FieldQuote / FieldShape | QUOTE / SHAPE поля; буквальный текст поля |
DocumentBuilder.InsertHyperlink | Сокращение для вставки гиперссылки высокого уровня |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Создание закладок и навигация к целевым объектам ссылки |