Freigeben über

WebControl.Attributes-Eigenschaft

  • Artikel

Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public ReadOnly Property Attributes As AttributeCollection
'Usage
Dim instance As WebControl
Dim value As AttributeCollection

value = instance.Attributes

public AttributeCollection Attributes { get; }

public:
property AttributeCollection^ Attributes {
    AttributeCollection^ get ();
}

/** @property */
public AttributeCollection get_Attributes ()

public function get Attributes () : AttributeCollection

Eigenschaftenwert

Eine AttributeCollection von Name-Wert-Paaren.

Hinweise

Die Attributes-Auflistung enthält eine Auflistung aller Attribute, die im öffnenden Tag eines Webserversteuerelements deklariert sind. Auf diese Weise können Sie die einem Webserversteuerelement zugeordneten Attribute programmgesteuert steuern. Sie können der Auflistung Attribute hinzufügen oder daraus entfernen.

Hinweis

Diese Eigenschaft wird unabhängig von den Browsereinstellungen zusammen mit allen Attributen der Auflistung im öffnenden Tag des Steuerelements dargestellt. Nicht alle Browser unterstützen jedes dargestellte Attribut. Die nicht unterstützten Attribute werden vom Browser i. d. R. ignoriert.

Hinweis

Clientseitige Skripts können einer WebControl-Instanz nicht über die Attributes-Auflistung hinzugefügt werden. Verwenden Sie hierfür die ClientScript-Eigenschaft für das Page-Steuerelement.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie mit der Attributes-Eigenschaft eines WebControl ein JavaScript-Befehl ausgeführt werden kann, wenn das TextBox-Steuerelement den Fokus verliert.

Hinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.

<%@ Page Language="VB" AutoEventWireup="True" %>

 <html>
 <head>
    <script language="VB" runat="server">
 
        Sub Page_Load(sender As Object, e As EventArgs)
            TextBox1.Attributes("onblur") = "javascript:alert('Hello! Focus lost from text box!!');"
        End Sub
    </script>
 
 </head>
 <body>
    <h3>Attributes Property of a Web Control</h3>
 <form runat="server">
 
    <asp:TextBox id="TextBox1" columns=54 
     Text="Click here and then tap out of this text box" 
     runat="server"/>  
 
 </form>
 </body>
 </html>
 

<%@ Page Language="C#" AutoEventWireup="True" %>

 <html>
 <head>
    <script language="C#" runat="server">
 
        void Page_Load(Object sender, EventArgs e) {
           TextBox1.Attributes["onblur"]="javascript:alert('Hello! Focus lost from text box!!');";    
        }
    </script>
 
 </head>
 <body>
    <h3>Attributes Property of a Web Control</h3>
 <form runat="server">
 
    <asp:TextBox id="TextBox1" columns=54 
     Text="Click here and then tap out of this text box" 
     runat="server"/>  
 
 </form>
 </body>
 </html>
 

<%@ Page Language="JScript" AutoEventWireup="True" %>

 <html>
 <head>
    <script language="JSCRIPT" runat="server">
 
        function Page_Load(sender : Object, e : EventArgs){
            TextBox1.Attributes("onblur") = "javascript:alert('Focus lost from text box!!');"
        }
    </script>
 
 </head>
 <body>
    <h3>Attributes Property of a Web Control</h3>
 <form runat="server">
 
    <asp:TextBox id="TextBox1" columns=54 
     Text="Click here and then tab out of this text box" 
     runat="server"/>  
 
 </form>
 </body>
 </html>
 

<html>
<head>
   <script language="C#" runat="server">

       void Page_Load(Object sender, EventArgs e) {
          TextBox1.Attributes["onblur"]="javascript:alert('Hello! Focus lost from text box!!');";    
       }
   </script>

</head>
<body>
   <h3><font face="Verdana">Attributes Property of a Web Control</font></h3>
<form runat="server">

   <asp:TextBox id="TextBox1" columns=54 
    Text="Click here and then tap out of this text box" 
    runat="server"/>  

</form>
</body>
</html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebControl-Klasse
WebControl-Member
System.Web.UI.WebControls-Namespace
System.Web.UI.AttributeCollection
System.Web.UI.ClientScriptManager

Weitere Ressourcen

Syntax des Webserversteuerelements
Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen