MobilePage.AllowCustomAttributes 属性

参考

定义

命名空间:: System.Web.UI.MobileControls

程序集:: System.Web.Mobile.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取一个值，该值指示是否可以为页上的控件定义自定义属性。默认值是 Web.config 文件的 <mobilecontrols> 部分的 allowCustomAttributes 特性的值。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。

public:
 property bool AllowCustomAttributes { bool get(); void set(bool value); };

[System.ComponentModel.Bindable(false)]
[System.ComponentModel.Browsable(false)]
public bool AllowCustomAttributes { get; set; }

[<System.ComponentModel.Bindable(false)>]
[<System.ComponentModel.Browsable(false)>]
member this.AllowCustomAttributes : bool with get, set

Public Property AllowCustomAttributes As Boolean

属性值

Boolean

如果可以为页上的控件定义自定义特性，则为 true；否则为 false。

属性: BindableAttribute BrowsableAttribute

示例

以下示例演示如何使用 AllowCustomAttributes 属性在上Command启用自定义AccessKey属性。

注意

下面的代码示例使用单文件代码模型，如果将它直接复制到代码隐藏文件中，则可能无法正常工作。必须将此代码示例复制到扩展名为 .aspx 的空文本文件中。有关详细信息，请参阅 ASP.NET Web 窗体页代码模型。

<%@ Page Language="C#" 
    Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile" 
    Namespace="System.Web.UI.MobileControls" 
    Assembly="System.Web.Mobile" %>
<%@ Import Namespace="System.Web.Mobile" %>

<script runat="server">
    // <Snippet2>
    private void Command_OnClick(object sender, EventArgs e)
    {
        // Display the other form
        if (ActiveForm.ID == "Form1")
            ActiveForm = Form2;
        else
            ActiveForm = Form1;
    }
    // </Snippet2>

    public bool isAccessKey(MobileCapabilities caps, 
        string optValue)
    {
        // Determine if the browser is not a Web crawler 
        // and can use access keys
        if (!caps.Crawler && caps.SupportsAccesskeyAttribute)
            return true;
        return false;
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
    <mobile:Form runat="server" id="Form1" >
        <mobile:Label Runat="server">This is Form1</mobile:Label>
        <mobile:Command id="cmd1" runat="server" Text="No AccessKey" 
            onClick="Command_OnClick">
            <DeviceSpecific>
               <Choice Filter="isAccessKey" Text="AccessKey is 1"/>
            </DeviceSpecific>
        </mobile:Command>
        <mobile:Label id="Label1" runat="server" />
    </mobile:Form>
    <mobile:Form ID="Form2" Runat="server">
        <mobile:Label Runat="server">This is Form2</mobile:Label>
        <mobile:Command id="cmd2" runat="server" text="Back to Form1"
            onClick="Command_OnClick">
            <DeviceSpecific>
                <Choice Filter="isAccessKey" Text="1 is AccessKey" AccessKey="1" />
            </DeviceSpecific>
        </mobile:Command>
    </mobile:Form>
</body>
</html>

<%@ Page Language="VB" 
    Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile" 
    Namespace="System.Web.UI.MobileControls" 
    Assembly="System.Web.Mobile" %>
<%@ Import Namespace="System.Web.Mobile" %>

<script runat="server">
    ' <Snippet2>
    Private Sub Command_OnClick(ByVal sender As Object, ByVal e As EventArgs)
        ' Display the other form
        If ActiveForm.ID = "Form1" Then
            ActiveForm = Form2
        Else
            ActiveForm = Form1
        End If
    End Sub
    ' </Snippet2>

    Public Function isAccessKey(ByVal caps As MobileCapabilities, _
        ByVal optValue As String) As Boolean
        
        ' Determine if the browser is not a Web crawler 
        ' and can use access keys
        If Not caps.Crawler AndAlso caps.SupportsAccesskeyAttribute Then
            Return True
        End If
        Return False
    End Function

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
    <mobile:Form runat="server" id="Form1" >
        <mobile:Label ID="Label1" Runat="server">This is Form1</mobile:Label>
        <mobile:Command id="cmd1" runat="server" Text="No AccessKey" 
            onClick="Command_OnClick">
            <DeviceSpecific>
               <Choice Filter="isAccessKey" Text="AccessKey is 1"/>
            </DeviceSpecific>
        </mobile:Command>
        <mobile:Label id="Label2" runat="server" />
    </mobile:Form>
    <mobile:Form ID="Form2" Runat="server">
        <mobile:Label ID="Label3" Runat="server">This is Form2</mobile:Label>
        <mobile:Command id="cmd2" runat="server" text="Back to Form1"
            onClick="Command_OnClick">
            <DeviceSpecific>
                <Choice Filter="isAccessKey" Text="1 is AccessKey" AccessKey="1" />
            </DeviceSpecific>
        </mobile:Command>
    </mobile:Form>
</body>
</html>

注解

除了 IAttributeAccessor 接口，ASP.NET 页框架还提供了一个 CustomAttributes 字典，可用于指定其他属性、启用或禁用自定义属性，或者调整控件的行为或呈现。若要启用或禁用自定义归因，可以将属性设置为 AllowCustomAttributestrue，也可以将 Web.config 节的 <mobileControls> 属性设置为 allowCustomAttributestrue。

注意

启用自定义属性后，属性名称中的排字错误可以解释为自定义属性。例如，如果开发人员错误地将控件的属性指定 Text 为“Txet”，分析程序会将其保存为名为“Txet”的自定义属性，而不是引发异常。因此，默认情况下禁用自定义属性。

适用于

通过

MobilePage.AllowCustomAttributes 属性

定义

属性值

示例

注解

适用于

另请参阅

其他资源