Freigeben über

WebControl.Enabled-Eigenschaft

  • Artikel

Ruft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest.

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

Syntax

'Declaration
<BindableAttribute(True)> _
<ThemeableAttribute(False)> _
Public Overridable Property Enabled As Boolean
'Usage
Dim instance As WebControl
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

[BindableAttribute(true)] 
[ThemeableAttribute(false)] 
public virtual bool Enabled { get; set; }

[BindableAttribute(true)] 
[ThemeableAttribute(false)] 
public:
virtual property bool Enabled {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Enabled ()

/** @property */
public void set_Enabled (boolean value)

public function get Enabled () : boolean

public function set Enabled (value : boolean)

Eigenschaftenwert

true, wenn das Steuerelement aktiviert ist, andernfalls false. Der Standardwert ist true.

Hinweise

Verwenden Sie die Enabled-Eigenschaft, um anzugeben oder zu bestimmen, ob ein Steuerelement aktiviert ist. Wenn das Steuerelement auf false festgelegt ist, wird es abgeblendet dargestellt, sodass das Steuerelement nicht für die Eingabe verwendet werden kann.

Hinweis

Diese Eigenschaft wird nicht von allen Browsern unterstützt. Das Abblenden und Sperren des Steuerelements funktioniert nur in Browsern, die mit Microsoft Internet Explorer, Version 4 oder höher, kompatibel sind.

Diese Eigenschaft wird in der Steuerelementhierarchie nach unten weitergegeben. Somit werden beim Deaktivieren eines Containersteuerelements alle darin enthaltenen untergeordneten Steuerelemente deaktiviert.

Hinweis

Beim Erstellen eines kundendefinierten zusammengesetzten Steuerelements trifft dieses Verhalten nicht für Steuerelemente zu, für die noch keine untergeordneten Steuerelemente erstellt wurden. Sie müssen entweder den aktivierten Zustand der untergeordneten Steuerelemente für den Zeitpunkt ihrer Erstellung festlegen, oder Sie rufen durch Überschreiben der Enabled-Eigenschaft die EnsureChildControls-Methode auf.

Diese Eigenschaft wird nicht von allen Steuerelementen unterstützt. Weitere Einzelheiten finden Sie unter den Ausführungen zu den einzelnen Steuerelementen.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und unter Übersicht über ASP.NET-Designs und ASP.NET-Skins.

Thema Position
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite Erstellen von Anwendungen mit Visual Web Developer

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie ein von der WebControl-Basisklasse geerbtes TextBox-Steuerelement durch programmgesteuertes Festlegen der Enabled-Eigenschaft aktiviert und deaktiviert wird.

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>
 <body>
 
     <h3>Enabled Property of a Web Control<br></h3>
 
 <script language="VB" runat="server">
 
    Sub SubmitBtn1_Click(sender As Object, e As EventArgs)
        TextBox1.Enabled = Not(TextBox1.Enabled)
    End Sub
 
 </script>
 
 <form runat=server>
 
     <asp:TextBox id="TextBox1" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightGreen" runat="server"/>
     <p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" 
     Text="Click to disable/enable the light blue text box" 
     runat="server"/>
     <p>
     
 </form>
 
 </body>
 </html>
 

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

<html>
 <body>
 
     <h3>Enabled Property of a Web Control<br></h3>
 
 <script language="C#" runat="server">
 
     void SubmitBtn1_Click(Object sender, EventArgs e) {
        TextBox1.Enabled = !(TextBox1.Enabled);
     }
 
 </script>
 
 <form runat=server>
 
     <asp:TextBox id="TextBox1" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightGreen" runat="server"/>
     <p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" 
     Text="Click to disable/enable the light blue text box" 
     runat="server"/>
     <p>
     
 </form>
 
 </body>
 </html>
 

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

<html>
 <body>
 
     <h3>Enabled Property of a Web Control<br></h3>
 
 <script language="JSCRIPT" runat="server">
 
    function SubmitBtn1_Click(sender : Object, e : EventArgs){
        TextBox1.Enabled = !TextBox1.Enabled
    }
 
 </script>
 
 <form runat=server>
 
     <asp:TextBox id="TextBox1" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightGreen" runat="server"/>
     <p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" 
     Text="Click to disable/enable the light blue text box" 
     runat="server"/>
     <p>
     
 </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
EnsureChildControls

Weitere Ressourcen

ASP.NET-Webserversteuerelemente und Browserfunktionen
Syntax des Webserversteuerelements
Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen