共用方式為


<DeviceSpecific> 項目

更新:2007 年 11 月

<DeviceSpecific> 項目提供一個建構,此建構可用來在樣板集的多種替換內容、以及需要裝置特定選項的控制項內指定選項。您通常會在 <DeviceSpecific> 項目內指定一個或多個 <Choice> 項目,而每個項目都包含指定如何根據目標裝置能力來評估選擇的屬性 (Attribute)。在執行階段,會依序評估每個選擇,並且使用成功評估的第一個選擇。每個 <Choice> 項目可以包含以下各項:

  • Filter 屬性,指定要評估的裝置篩選條件名稱。

  • 其他會覆寫父控制項屬性的屬性。

  • 控制項的樣板定義

如果省略 Filter 屬性,Choice 項目就一定會評估為 true。如果在挑選之前沒有宣告其他選擇,則會按照預設挑出選擇。

屬性

屬性

描述

Choices

傳回 <DeviceSpecific> 項目中的 Choice 集合。

HasTemplates

如果目前選取的 <DeviceSpecific>/<Choice> 建構選項內有已定義樣板,就會傳回 true。

MobilePage

傳回包含這個 <DeviceSpecific> 項目的行動網頁。

Owner

傳回這個 <DeviceSpecific> 項目的擁有者,可能是是控制項或是樣式。

SelectedChoice

傳回目前選取的選項,如果都不適用,則傳回 null。

內含項目規則

下列控制項可包含 <DeviceSpecific> 項目。

控制項

註解

MobileControl

MobileControl 控制項,或是繼承自 MobileControl 物件的任何控制項,其可以包含零或一個 <DeviceSpecific> 項目。

Style

Style 控制項,或是繼承自 Style 物件的任何項目,其可以包含零或一個 <DeviceSpecific> 項目。

<DeviceSpecific> 項目可包含下列控制項。

控制項

註解

DeviceSpecificChoice

<DeviceSpecific> 控制項可包含任何數目的 DeviceSpecificChoice 控制項。

範例

描述

這個範例會使用 PrefersGIF 和 PrefersWBMP 裝置篩選條件,根據裝置能力在三個影像 URL 中進行選擇。

注意事項:

指定的裝置篩選條件必須出現在 Web.config 檔中。如需詳細資訊,請參閱行動裝置能力

錯誤碼

<DeviceSpecific>
  <Choice Filter="PrefersGIF" ImageUrl="colorImg.gif"/>
  <Choice Filter="PrefersWBMP" ImageUrl="myImage.wbmp"/>
  <Choice ImageUrl="monoImg.gif"/>
</DeviceSpecific>

請參閱

概念

行動控制項參考

參考

<Choice> 項目 (.NET Framework 開發人員手冊)

其他資源

項目參考