MobilePage.AllowCustomAttributes Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.MobileControls
Assembly:
System.Web.Mobile.dll

Ruft einen Wert ab, der angibt, ob für die Steuerelemente auf der Seite benutzerdefinierte Attribute festgelegt sein können. Der Standardwert ist der Wert des allowCustomAttributes-Attributs des <mobilecontrols>-Abschnitts der Datei „Web.config“. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit 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

Eigenschaftswert

Boolean

true, wenn für die Steuerelemente auf der Seite benutzerdefinierte Attribute festgelegt sein können, andernfalls false.

Attribute
BindableAttribute BrowsableAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die AllowCustomAttributes -Eigenschaft verwenden, um das benutzerdefinierte AccessKey Attribut für zu Commandaktivieren.

Hinweis

Das folgende Codebeispiel verwendet das Einzeldateicodemodell und funktioniert möglicherweise nicht ordnungsgemäß, wenn Sie es direkt in eine CodeBehind-Datei kopieren. Sie müssen dieses Codebeispiel in eine leere Textdatei mit der Erweiterung ASPX kopieren. Weitere Informationen finden Sie unter ASP.NET Web Forms Seitencodemodell.

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

Hinweise

Zusätzlich zur IAttributeAccessor Schnittstelle stellt das ASP.NET-Seitenframework ein CustomAttributes Wörterbuch bereit, mit dem Sie zusätzliche Attribute angeben, die benutzerdefinierte Attributierung aktivieren oder deaktivieren oder das Verhalten oder Rendering eines Steuerelements anpassen können. Um die benutzerdefinierte Attributierung zu aktivieren oder zu deaktivieren, können Sie entweder die AllowCustomAttributes Eigenschaft auf truefestlegen, oder Sie können das allowCustomAttributes Attribut des <mobileControls> Abschnitts von Web.config auf truefestlegen.

Hinweis

Wenn benutzerdefinierte Attribute aktiviert sind, können typografische Fehler in Eigenschaftennamen als benutzerdefinierte Attribute interpretiert werden. Wenn ein Entwickler beispielsweise die Text Eigenschaft eines Steuerelements fälschlicherweise als "Txet" angibt, würde der Parser es als benutzerdefiniertes Attribut namens "Txet" speichern, anstatt eine Ausnahme auszuheben. Aus diesem Grund sind benutzerdefinierte Attribute standardmäßig deaktiviert.

Gilt für:

Weitere Informationen