HtmlInputCheckBox.OnServerChange-Methode
Löst das ServerChange-Ereignis aus. Mithilfe dieser Methode können Sie das Ereignis direkt behandeln.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Protected Overridable Sub OnServerChange ( _
e As EventArgs _
)
'Usage
Dim e As EventArgs
Me.OnServerChange(e)
protected virtual void OnServerChange (
EventArgs e
)
protected:
virtual void OnServerChange (
EventArgs^ e
)
protected void OnServerChange (
EventArgs e
)
protected function OnServerChange (
e : EventArgs
)
Parameter
- e
Ein System.EventArgs, das Ereignisdaten enthält.
Hinweise
Dieses Ereignis wird ausgelöst, wenn die Webseite an den Server gesendet wird und sich der Zustand des HtmlInputCheckBox-Steuerelements seit der letzten Übermittlung geändert hat. Mit dieser Methode können Sie die Basisimplementierung überschreiben und einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Hinweis
Der Ansichtszustand für das Steuerelement muss aktiviert sein, damit das ServerChange-Ereignis ordnungsgemäß funktioniert.
Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Auslösen eines Ereignisses.
Die OnServerChange-Methode ermöglicht es auch abgeleiteten Klassen, das Ereignis ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.
Hinweise für Erben Wenn Sie OnServerChange in einer abgeleiteten Klasse überschreiben, müssen Sie unbedingt die OnServerChange-Methode der Basisklasse aufrufen, sodass registrierte Delegaten das Ereignis empfangen.
Beispiel
Im folgenden Codebeispiel wird das Angeben und Codieren eines Handlers für das ServerChange-Ereignis veranschaulicht.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script language="VB" runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
If Prev_Check_State.InnerHtml = Check1.Checked.ToString() Then
Span2.InnerHtml = "CheckBox1 did not change state between clicks."
End If
If Check1.Checked = True Then
Span1.InnerHtml = "CheckBox1 is selected!"
Prev_Check_State.InnerHtml = "True"
Else
Span1.InnerHtml = "CheckBox1 is not selected!"
Prev_Check_State.InnerHtml = "False"
End If
End Sub 'Button1_Click
Sub Server_Changed(sender As Object, e As EventArgs)
Span2.InnerHtml = "CheckBox1 changed state between clicks."
End Sub 'Server_Changed
</script>
</head>
<body>
<h3>HtmlInputCheckBox Sample</h3>
<form runat=server>
<input id="Check1"
type="checkbox"
OnServerChange="Server_Changed"
runat="server"/>
CheckBox1
<span id="Span1"
style="color:red"
runat="server"/>
<p>
<input type="button"
id="Button1"
value="Enter"
OnServerClick="Button1_Click"
runat="server"/>
<br><br>
<span id="Span2"
runat="server"/>
<htmlinputhidden id="Prev_Check_State"
Visible="false"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script language="C#" runat="server">
void Button1_Click(object sender, EventArgs e)
{
if (Prev_Check_State.InnerHtml == Check1.Checked.ToString())
Span2.InnerHtml = "CheckBox1 did not change state between clicks.";
if (Check1.Checked == true)
{
Span1.InnerHtml = "CheckBox1 is selected!";
Prev_Check_State.InnerHtml="True";
}
else
{
Span1.InnerHtml = "CheckBox1 is not selected!";
Prev_Check_State.InnerHtml="False";
}
}
void Server_Changed(object sender, EventArgs e)
{
Span2.InnerHtml = "CheckBox1 changed state between clicks.";
}
</script>
</head>
<body>
<h3>HtmlInputCheckBox Sample</h3>
<form runat=server>
<input id="Check1"
type="checkbox"
OnServerChange="Server_Changed"
runat="server"/>
CheckBox1
<span id="Span1"
style="color:red"
runat="server"/>
<p>
<input type="button"
id="Button1"
value="Enter"
OnServerClick="Button1_Click"
runat="server"/>
<br><br>
<span id="Span2"
runat="server"/>
<htmlinputhidden id="Prev_Check_State"
Visible="false"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>
<script language="JSCRIPT" runat="server">
function Button1_Click(sender : Object, e : EventArgs){
if(Prev_Check_State.InnerHtml == Check1.Checked.ToString())
Span2.InnerHtml = "CheckBox1 did not change state between clicks."
if(Check1.Checked){
Span1.InnerHtml = "CheckBox1 is selected!"
Prev_Check_State.InnerHtml = "True"
}else{
Span1.InnerHtml = "CheckBox1 is not selected!"
Prev_Check_State.InnerHtml = "False"
}
}
function Server_Changed(sender : Object, e : EventArgs){
Span2.InnerHtml = "CheckBox1 changed state between clicks."
}
</script>
</head>
<body>
<h3>HtmlInputCheckBox Sample</h3>
<form runat=server>
<input id="Check1"
type="checkbox"
OnServerChange="Server_Changed"
runat="server"/>
CheckBox1
<span id="Span1"
style="color:red"
runat="server"/>
<p>
<input type="button"
id="Button1"
value="Enter"
OnServerClick="Button1_Click"
runat="server"/>
<br><br>
<span id="Span2"
runat="server"/>
<htmlinputhidden id="Prev_Check_State"
Visible="false"
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
HtmlInputCheckBox-Klasse
HtmlInputCheckBox-Member
System.Web.UI.HtmlControls-Namespace
ServerChange
System.EventArgs