MobilePage.AllowCustomAttributes Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.MobileControls

Assembly:: System.Web.Mobile.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 & Sites 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

Im folgenden Codebeispiel wird das Einzeldateicodemodell verwendet, und es funktioniert möglicherweise nicht ordnungsgemäß, wenn Sie es direkt in eine CodeBehind-Datei kopieren. Sie müssen dieses Codebeispiel in eine leere Textdatei kopieren, die über eine .aspx-Erweiterung verfügt. 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, benutzerdefinierte Attributierung aktivieren oder deaktivieren oder das Verhalten oder Rendering eines Steuerelements anpassen können. Um 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 Typografiefehler in Eigenschaftennamen als benutzerdefinierte Attribute interpretiert werden. Wenn ein Entwickler beispielsweise die Text Eigenschaft eines Steuerelements fälschlicherweise als "Txet" angibt, speichert der Parser es als benutzerdefiniertes Attribut namens "Txet", anstatt eine Ausnahme auslösen zu lassen. Aus diesem Grund sind benutzerdefinierte Attribute standardmäßig deaktiviert.

Gilt für:

Freigeben über