MobilePage.AllowCustomAttributes Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.MobileControls
Sestavení:
System.Web.Mobile.dll

Získá hodnotu označující, zda ovládací prvky na stránce mohou mít vlastní atributy definované. Výchozí hodnota je hodnota atributu allowCustomAttributes<mobilecontrols> oddílu souboru Web.config. Toto rozhraní API je zastaralé. Informace o vývoji ASP.NET mobilních aplikací najdete v tématu Mobilní aplikace & weby s 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

Hodnota vlastnosti

Boolean

truePokud ovládací prvky na stránce mohou mít definované vlastní atributy; v opačném případě . false

Atributy
BindableAttribute BrowsableAttribute

Příklady

Následující příklad ukazuje použití AllowCustomAttributes vlastnosti k povolení vlastního AccessKey atributu v objektu Command.

Poznámka

Následující ukázka kódu používá model kódu s jedním souborem a nemusí fungovat správně, pokud ho zkopírujete přímo do souboru kódu na pozadí. Tuto ukázku kódu musíte zkopírovat do prázdného textového souboru s příponou .aspx. Další informace najdete v tématu ASP.NET model kódu stránky webových formulářů.

<%@ 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>

Poznámky

Kromě IAttributeAccessor rozhraní poskytuje rozhraní ASP.NET stránky CustomAttributes slovník, který umožňuje zadat další atributy, povolit nebo zakázat vlastní přisuzování nebo upravit chování nebo vykreslování ovládacího prvku. Pokud chcete povolit nebo zakázat vlastní přisuzování, můžete buď nastavit AllowCustomAttributes vlastnost na true, nebo můžete nastavit allowCustomAttributes atribut <mobileControls> oddílu Web.config na true.

Poznámka

Pokud jsou povoleny vlastní atributy, můžou být typografické chyby v názvech vlastností interpretovány jako vlastní atributy. Pokud například vývojář nesprávně určí Text vlastnost ovládacího prvku jako "Txet", analyzátor ji uloží jako vlastní atribut s názvem "Txet" místo vyvolání výjimky. Z tohoto důvodu jsou vlastní atributy ve výchozím nastavení zakázané.

Platí pro

Viz také