行動控制項的自訂屬性

更新：2007 年 11 月

所有的 ASP.NET Mobile 控制項都允許您使用 ASP.NET Web 網頁的 IAttributeAccessor 介面來設定自訂控制項屬性 (Attribute)。這個介面提供 GetAttribute 和 SetAttribute 方法。此外，MobileControl 類別 (Class) 會公開名為 CustomAttributes 的集合。

自訂屬性可以用來指定其他關於控制項的屬性，也能用在裝置特定的配置器中來調整控制項的行為或呈現。

預設上，會停用在控制項上設定自訂屬性的功能。有兩種方法可以啟用自訂屬性：

• 設定 Web.config 檔中 <mobileControls> 區段的屬性，如下列程式碼範例所示：

  <configuration>
    <system.web>
          ...
        <mobileControls allowCustomAttributes="True" />
        ...
    </system.web>
  </configuration>
  

  這個設定會影響應用程式中所有頁面的預設值。

• 將 MobilePage 類別的 AllowCustomAttributes 屬性設定為 true。這個設定會影響頁面中的所有控制項。

TextBox 控制項的 wmlFormat 屬性會傳送到 WML 裝置，並成為 WML <input> 項目的 Format 屬性。這是自訂屬性，和控制項的第一級屬性 (Attribute) 不同。然而，在自訂屬性可以作用之前，您必須先啟動它們。如需有效格式的完整清單，請參閱＜WML 規格＞(英文)，請自 http://www.wapforum.org 的「無線應用程式通訊協定論壇 (WAP)」取得此規格。

wmlFormat 屬性 (Attribute) 會覆寫 TextBox 控制項的 Numeric 屬性 (Property)。例如，如果 wmlFormat 屬性設定為 "NNN"，<input> 項目便會限制成三個數值字元。

注意事項：
自訂屬性 (Attribute) 開啟時，屬性 (Property) 名稱中的印刷樣式可能會被誤認為是自訂屬性 (Attribute)。例如，如果您將控制項的 Text 屬性 (Property) 錯誤地指定成 "Txet"，剖析器 (Parser) 便會將它儲存成名為 "Txet" 的自訂屬性 (Attribute)，而不會引發例外狀況 (Exception)。為了避免這種情形，預設使用者屬性為禁止變更。

請參閱

概念

設定多種裝置的 Web 應用程式

裝置篩選建議事項

裝置評估方法

擴充的瀏覽器能力

參考

HasCapability

MobileControl

其他資源

建立自訂的行動控制項