Справка по XML-элементам WebpageControlOptions
Вы можете отображать содержимое, определенное для веб-страницы или в теге CDATA, в форме рабочего элемента с помощью элемента WebpageControlOptions. Чтобы указать URL-адрес или HTML-код для отображения содержимого в форме, можно включить дочерний элемент Link или Content.
Чтобы добавить элементы в форму, измените тип рабочего элемента. См. раздел Изменение или добавление пользовательского типа рабочего элемента (WIT).
Элемент WebpageControlOptions является дочерним по отношению к элементу CONTROL.
Схема иерархии
<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" > <Link UrlRoot="UrlRoot" UrlPath="UrlPathWithParameters"> <Param Index="IndexValue " Value="Param Value " Type="Original | Current" /> </Link> <Content> <![CDATA[Contents of HTML]]> </Content> </WebpageControlOptions>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние и родительские элементы.
Дочерние элементы и атрибуты
Элемент |
Атрибут |
Описание |
|---|---|---|
WebpageControlOptions |
|
Необязательный элемент Control при type="WebpageControl". Элемент-контейнер для определения URL-адреса, содержимое которого будет отображаться в форме рабочего элемента. Необязательный элемент Link. Требуется, если задан параметр UrlPath. Указывает значение, которое должно использоваться для определения URL-адреса гиперссылки, если указан параметр UrlPath. Этот элемент имеет сложный тип WebpageControlOptionsType. |
|
AllowScript |
Необязательный атрибут элемента WebpageControlOptions. Указывает, разрешено ли запускать JavaScript на веб-странице (true) или нет (false). Тип атрибута —xs:boolean. Все прочие параметры, такие как ActiveX, основаны на параметрах Internet Explorer, определенных для клиента. |
|
ReloadOnParamChange |
Необязательный атрибут элемента WebpageControlOptions. Указывает, следует ли перезагружать (true) содержимое веб-страницы при изменении параметра в форме рабочего элемента (true) или нет (false). Тип атрибута —xs:boolean. Значение по умолчанию — true. |
Link |
|
Необязательный элемент WebpageControlOptions. Этот элемент является взаимоисключающим с элементом Content. Указывает URL-адрес веб-страницы для отображения в форме рабочего элемента. Для получения дополнительной информации см. Справка по XML-элементам Link и Param. |
Content |
|
Необязательный элемент WebpageControlOptions. Этот элемент является взаимоисключающим с элементом Link. Задает содержимое HTML, которое должно отображаться элементом управления веб-страницы. Содержимое указывается внутри тега CDATA. Например: <![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]> Тип элемента — xs:string. Примечание Содержимое HTML не проверяется до отображения его в форме рабочего элемента. |
Родительские элементы
Элемент |
Описание |
|---|---|
Обязательный родительский элемент. Определяет отображение в форме рабочего элемента поля, текста, гиперссылки или другого элемента управления. |
|
Необязательный элемент LabelText. Элемент контейнера для информации или метки, отображаемых в форме рабочего элемента. Для получения дополнительной информации см. Справка по XML-элементам LabelText и Text. |
Заметки
Элементы Link и Content являются взаимоисключающими.
Атрибуты AllowScript и ReloadOnParamChange не допускаются при использовании элемента Content.
При настройке элемента управления веб-страницы для отображения необработанного HTML все скрипты отключаются. Все гиперссылки в содержимом при щелчке по ним открываются в веб-браузере Visual Studio, если форма рабочего элемента отображается в Visual Studio, или в Internet Explorer.
Несколько кнопок панели инструментов добавляются в форму рабочего элемента для вкладки, содержащей WebpageControl. Эти параметры включают следующие функции:
Навигация назад и вперед.
Остановка загрузки содержимого и обновление содержимого.
Возврат на домашнюю страницу содержимого.
Открытие содержимого в новом окне или во внешнем браузере.
Кроме того, если загружаемая веб-страница содержит ненадежное содержимое, то значок блокируется, и появляется заблокированный значок.
Элемент WebpageControlOptions распознается только клиентами, на которых работает последняя версия Team Explorer. Для предыдущих версий отображается красная область, и появляется сообщение о том, что элемент управления не удалось найти. Для получения дополнительной информации см. Предоставление текста справки, гиперссылок или веб-содержимого в форму рабочего элемента.
Пример
В следующем примере показывается, как загрузить в форму рабочего элемента HTML, заданный в теге CDATA.
<Control Type="WebpageControl">
<WebpageControlOptions>
<Content>
<![CDATA[Click here for detailed <b><a href="https://www.microsoft.com">Process Guidance</a></b>]]>
</Content>
</WebpageControlOptions>
</Control>
Определения схемы
WebpageControlOptionsType
<xs:complexType name="WebpageControlOptionsType">
<xs:choice minOccurs="1" maxOccurs="1">
<xs:element name="Link" type="HyperLinkType"/>
<xs:element name="Content" type="xs:string"/>
</xs:choice>
<xs:attribute name="AllowScript" type="xs:boolean" use="optional" />
<xs:attribute name="ReloadOnParamChange" type="xs:boolean" use="optional" />
</xs:complexType>
NonBlankString
<xs:simpleType name="NonBlankString">
<xs:restriction base="xs:string">
<xs:pattern value=".*\S+.*"/>
</xs:restriction>
</xs:simpleType>
Сведения об элементе
Пространство имен |
https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef |
Имя схемы |
Определение типа рабочего элемента |
Файл проверки |
WorkItemTypeDefinition.xsd |
Тип элемента |
WebpageControlOptionsType |
Может быть пустым |
Неприменимо |
См. также
Основные понятия
Указание элементов управления на форме рабочего элемента
Разработка формы рабочего элемента
Другие ресурсы
Предоставление текста справки, гиперссылок или веб-содержимого в форму рабочего элемента