WebpageControlOptions XML 項目參考
您可以使用 WebpageControlOptions 項目來顯示針對網頁定義的內容，或是工作項目表單上之 CDATA 標記內的內容。 您可以包含 Link或 Content 子項目，指定要顯示在表單中的內容的 URL 或 HTML。
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>
屬性和項目
下列章節會說明屬性、子項目和父項目。
.gif "Dd936135.collapse_all(zh-tw,VS.110).gif")
子項目及屬性
元素 |
屬性 |
描述 |
|---|---|---|
WebpageControlOptions |
|
當 type="WebpageControl" 時，選擇性 Control 項目。 定義 URL 的容器項目，此 URL 的內容會在工作項目表單中呈現。 選擇性 Link 項目。 指定 UrlPath 時為必要項。 指定值，當指定 UrlPath 時，這個值用於決定超連結的 URL。 項目型別是複雜型別：WebpageControlOptionsType。 |
|
AllowScript |
選擇性 WebpageControlOptions 屬性。 指定是否允許執行網頁內的 JavaScript (true 表示允許、false 表示不允許)。 屬性型別為 xs:boolean。 所有其他設定 (例如 ActiveX) 都是以該用戶端設定的 Internet Explorer 設定為基礎。 |
|
ReloadOnParamChange |
選擇性 WebpageControlOptions 屬性。 指定當工作項目表單中的參數變更時 (true) 是否要重新載入 (true) 網頁的內容 (false 表示不重新載入)。 屬性型別為 xs:boolean。 預設值是 true。 |
Link |
|
選擇性 WebpageControlOptions 項目。 這個項目與 Content 項目互斥。 指定要在工作項目表單中呈現的網頁 URL。 如需詳細資訊，請參閱Link 和 Param XML 項目參考。 |
Content |
|
選擇性 WebpageControlOptions 項目。 這個項目與 Link 項目互斥。 指定要由 Web 網頁控制項所呈現的 HTML 內容。 內容會在 CDATA 標記內指定。 例如： <![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]> 項目型別是 xs:string。 .gif "注意事項") 注意事項
在工作項目表單中呈現 HTML 內容之前，不會驗證該內容。
|
父項目
元素 |
描述 |
|---|---|
必要的父項目。 定義要顯示在工作項目表單上的欄位、文字、超連結或其他控制項項目。 |
|
選擇性 LabelText 項目。 容器項目，容納要顯示在工作項目表單上的資訊或標籤。 如需詳細資訊，請參閱LabelText 和 Text XML 項目參考。 |
備註
Link 和 Content 項目互斥。
使用 Content 項目時，不允許使用 AllowScript 和 ReloadOnParamChange 屬性。
將網頁控制項設定為顯示未經處理的 HTML 時，會停用所有指令碼處理。 如果工作項目表單顯示在Visual Studio 或 Internet Explorer 中，內容中任何按下的超連結都會在 Visual Studio Web 瀏覽器中開啟。
在包含 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 |
可以是空白 |
不適用 |