WebControl.Enabled Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement webserver is ingeschakeld.
public:
virtual property bool Enabled { bool get(); void set(bool value); };[System.ComponentModel.Bindable(true)]
public virtual bool Enabled { get; set; }[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public virtual bool Enabled { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.Enabled : bool with get, set[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
member this.Enabled : bool with get, setPublic Overridable Property Enabled As BooleanWaarde van eigenschap
true als het besturingselement is ingeschakeld; anders, false. De standaardwaarde is true.
- Kenmerken
Voorbeelden
In het volgende voorbeeld ziet u hoe u een TextBox besturingselement, overgenomen van de WebControl basisklasse, inschakelt en uitschakelt door de eigenschap programmatisch in te stellen Enabled .
Note
Het volgende codevoorbeeld maakt gebruik van het codemodel met één bestand en werkt mogelijk niet correct als deze rechtstreeks naar een codeachterstaand bestand wordt gekopieerd. Dit codevoorbeeld moet worden gekopieerd naar een leeg tekstbestand met een .aspx-extensie. Zie ASP.NET Web Forms Page Code Model voor meer informatie over het webformuliercodemodel.
Important
Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void SubmitBtn1_Click(object sender, EventArgs e)
{
TextBox1.Enabled = (!TextBox1.Enabled);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>Enabled Property Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Enabled Property of a Web Control</h3>
<p>
<asp:TextBox id="TextBox1" BackColor="LightBlue"
runat="server">Light Blue</asp:TextBox>
</p>
<p>
<asp:TextBox id="TextBox2" BackColor="LightGreen"
runat="server">Light Green</asp:TextBox>
</p>
<asp:Button id="SubmitBtn1" runat="server"
Text="Click to disable or enable the light blue text box"
OnClick="SubmitBtn1_Click" />
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub SubmitBtn1_Click(ByVal sender As Object, ByVal e As EventArgs)
TextBox1.Enabled = Not (TextBox1.Enabled)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>Enabled Property Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Enabled Property of a Web Control</h3>
<p>
<asp:TextBox id="TextBox1" BackColor="LightBlue"
runat="server">Light Blue</asp:TextBox>
</p>
<p>
<asp:TextBox id="TextBox2" BackColor="LightGreen"
runat="server">Light Green</asp:TextBox>
</p>
<asp:Button id="SubmitBtn1" runat="server"
Text="Click to disable or enable the light blue text box"
OnClick="SubmitBtn1_Click" />
</div>
</form>
</body>
</html>
Opmerkingen
Wanneer de Enabled eigenschap van een besturingselement is ingesteld falseop, wordt het besturingselement meestal grijs weergegeven. Als het besturingselement een invoerelement is, voorkomt de browser dat de gebruiker erop klikt of typt. HTML-elementen die worden weergegeven voor een serverbesturing, worden gemarkeerd als uitgeschakeld door hun disabled kenmerk of css-kenmerk class in te stellen. Zie voor meer informatie SupportsDisabledAttribute en ControlRenderingCompatibilityVersion.
Deze eigenschap wordt doorgegeven aan de besturingshiërarchie. Als u een containerbesturingselement uitschakelt, worden de onderliggende besturingselementen in die container ook uitgeschakeld. Voor meer informatie, zie de eigenschap IsEnabled.
Note
In een aangepast samengesteld besturingselement is dit overnamegedrag niet van toepassing op besturingselementen die nog geen onderliggende besturingselementen hebben gemaakt. U moet de ingeschakelde status van de onderliggende besturingselementen instellen wanneer deze worden gemaakt of de eigenschap overschrijven om de EnabledEnsureChildControls methode aan te roepen.
Note
Als u een besturingselement uitschakelt, voorkomt u alleen interactie met het besturingselement door de gebruiker via de gebruikersinterface van de browser. Het is mogelijk dat een gebruiker een aanvraag maakt waarmee een postback wordt ingediend die door de pagina wordt verwerkt, zelfs als besturingselementen op de pagina zijn uitgeschakeld. Voordat u een postback-aanvraag verwerkt, controleert u of het besturingselement is ingeschakeld en zichtbaar is.
Niet alle besturingselementen ondersteunen deze eigenschap. Zie de afzonderlijke besturingselementen voor meer informatie.
Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.