共用方式為

WebpageControlOptions XML 項目參考

  • 發行項

您可以使用 WebpageControlOptions 項目，顯示為網頁定義的內容，或是在工作項目表單上的 CDATA 標記中定義的內容。 您可以包含 Link 或 Content 子項目，以指定要在表單中顯示內容的 URL 或 HTML。

若要將項目加入表單，您可以修改工作項目類型。 請參閱 修改或加入自訂工作項目類型 (WIT)。

WebpageControlOptions 項目是 CONTROL 項目的子項目。

結構描述階層架構

WITD

   WORKITEMTYPE

       FORM

           配置

               群組

               Column

               TabGroup

                  索引標籤

                     控制項

<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 時為必要項目。

指定 UrlPath 時，可指定要用來判斷超連結 URL 的值。

項目類型是複雜類型：WebpageControlOptionsType。

 

AllowScript

選擇性 WebpageControlOptions 屬性。

指定允許 (true) 或不允許 (false) 網頁中的 JavaScript 執行。 屬性類型為 xs:boolean。

所有其他設定 (例如 ActiveX) 都是根據為用戶端定義的 Internet Explorer 設定。

 

ReloadOnParamChange

選擇性 WebpageControlOptions 屬性。

指定當工作項目表單中的參數變更 (true) 或不變更 (false) 時，是否要重新載入 (true) 網頁的內容。 屬性類型為 xs:boolean。

預設值是 true。

Link

 

選擇性 WebpageControlOptions 項目。 此項目與 Content 項目互斥。

指定要呈現在工作項目表單中之網頁的 URL。

如需詳細資訊，請參閱Link 和 Param XML 項目參考。

Content

 

選擇性 WebpageControlOptions 項目。

此項目與 Link 項目互斥。

指定網頁控制項所要呈現的 HTML 內容。 內容指定在 CDATA 標記中。 例如：

<![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]>

項目類型為 xs:string。

注意事項注意事項

在將 HTML 內容呈現在工作項目表單中之前，不會先行驗證。

父項目

項目

描述

控制項

必要的父項目。 定義要顯示在工作項目表單上的欄位、文字、超連結或其他控制項項目。

Text

選擇性 LabelText 項目。

容器項目，容納要顯示在工作項目表單上的資訊或標籤。

如需詳細資訊，請參閱LabelText 和 Text XML 項目參考。

備註

Link 與 Content 項目互斥。

當您使用 Content 項目時，不允許 AllowScript 和 ReloadOnParamChange 屬性。

當網頁控制項設定為顯示原始 HTML 時，所有指令碼會停用。 如果工作項目表單顯示在 Visual Studio 或 Internet Explorer 中，按一下內容中的任何超連結，就會在 Visual Studio 網頁瀏覽器中開啟。

包含 WebpageControl 之索引標籤的工作項目表單中，加入了數個工具列按鈕。 這些選項包括下列功能：

  • 向後和向前巡覽

  • 停止內容載入和重新整理內容

  • 回到內容首頁

  • 在新視窗或外部瀏覽器中開啟內容

此外，如果所要載入的網頁包含不受信任的內容，則會封鎖該圖示，且封鎖的圖示會出現。

只有執行最新版 Team Explorer 的用戶端會辨識 WebpageControlOptions 項目。 若為舊版，則會顯示紅色區域，並出現訊息指出找不到控制項。 如需詳細資訊，請參閱在工作項目表單上提供說明文字、超連結或 Web 內容。

範例

下列範例示範如何載入在 CDATA 標記中定義 HTML 的工作項目表單。

<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

可以是空白

不適用

請參閱

概念

指定工作項目表單控制項

設計工作項目表單

其他資源

在工作項目表單上提供說明文字、超連結或 Web 內容