HtmlInputRadioButton.OnServerChange-Methode
Löst das ServerChange-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Ereignishandler erstellen, wenn das Ereignis ausgelöst wird.
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 die Ereignisdaten enthält.
Hinweise
Das ServerChange-Ereignis wird ausgelöst, wenn die Checked-Eigenschaft des HtmlInputRadioButton-Steuerelements zwischen Bereitstellungen auf dem Server geändert wird. Auf diese Weise können Sie einen benutzerdefinierten Ereignishandler erstellen, der beim Auslösen des Ereignisses eine spezielle Gruppe von Anweisungen ausführt (z. B. eine Datenvalidierung).
Hinweis
Der Ansichtszustand für das Steuerelement muss aktiviert sein, damit das ServerChange-Ereignis ordnungsgemäß funktioniert. Legen Sie die Page.EnableViewState-Eigenschaft auf true fest, um den Ansichtszustand für alle Steuerelemente der Web Forms-Seite zu aktivieren. Sie können den Ansichtszustand auch für ein einzelnes Steuerelement aktivieren, indem Sie die Control.EnableViewState-Eigenschaft auf true festlegen.
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. Der benutzerdefinierte Ereignishandler aktualisiert eine Bezeichnung auf der Webseite, um den Wert des aktivierten Optionsfelds anzuzeigen.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub Server_Change(sender As Object , e As EventArgs)
If Radio1.Checked Then
Span1.InnerHtml = "You selected " & _
Radio1.Value
ElseIf Radio2.Checked Then
Span1.InnerHtml = "You selected " & _
Radio2.Value
ElseIf Radio3.Checked Then
Span1.InnerHtml = "You selected " & _
Radio3.Value
End If
End Sub
</script>
</head>
<body>
<form runat="server">
<h3>HtmlInputRadioButton Sample</h3>
<input type="radio"
id="Radio1"
name="Mode"
value="Radio Button 1"
OnServerChange="Server_Change"
runat="server"/>
Option 1
<br>
<input type="radio"
id="Radio2"
name="Mode"
value="Radio Button 2"
OnServerChange="Server_Change"
runat="server"/>
Option 2
<br>
<input type="radio"
id="Radio3"
name="Mode"
value="Radio Button 3"
OnServerChange="Server_Change"
runat="server"/>
Option 3
<p>
<input type="submit"
id="Button1"
value="Submit"
runat="server"/>
<p>
<span id="Span1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void Server_Change(object sender, EventArgs e)
{
if (Radio1.Checked)
Span1.InnerHtml = "You selected " +
Radio1.Value;
else if (Radio2.Checked)
Span1.InnerHtml = "You selected " +
Radio2.Value;
else if (Radio3.Checked)
Span1.InnerHtml = "You selected " +
Radio3.Value;
}
</script>
</head>
<body>
<form runat="server">
<h3>HtmlInputRadioButton Sample</h3>
<input type="radio"
id="Radio1"
name="Mode"
value="Radio Button 1"
OnServerChange="Server_Change"
runat="server"/>
Option 1
<br>
<input type="radio"
id="Radio2"
name="Mode"
value="Radio Button 2"
OnServerChange="Server_Change"
runat="server"/>
Option 2
<br>
<input type="radio"
id="Radio3"
name="Mode"
value="Radio Button 3"
OnServerChange="Server_Change"
runat="server"/>
Option 3
<p>
<input type="submit"
id="Button1"
value="Submit"
runat="server"/>
<p>
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub Server_Change(sender As Object, e As EventArgs)
If Radio1.Checked Then
Span1.InnerHtml = "You selected " & Radio1.Value
ElseIf Radio2.Checked Then
Span1.InnerHtml = "You selected " & Radio2.Value
ElseIf Radio3.Checked Then
Span1.InnerHtml = "You selected " & Radio3.Value
End If
End Sub
Sub Page_Load(sender As Object, e As EventArgs)
' Create an EventHandler delegate for the method you want to
' handle the event, and then add it to the list of methods
' called when the event is raised.
AddHandler Radio1.ServerChange, AddressOf Server_Change
AddHandler Radio2.ServerChange, AddressOf Server_Change
AddHandler Radio3.ServerChange, AddressOf Server_Change
End Sub
</script>
</head>
<body>
<form runat="server">
<h3>HtmlInputRadioButton ServerChange Example</h3>
<input type="radio"
id="Radio1"
name="Mode"
value="Radio Button 1"
runat="server"/>
Option 1
<br>
<input type="radio"
id="Radio2"
name="Mode"
value="Radio Button 2"
runat="server"/>
Option 2
<br>
<input type="radio"
id="Radio3"
name="Mode"
value="Radio Button 3"
runat="server"/>
Option 3
<p>
<input type="submit"
id="Button1"
value="Submit"
runat="server"/>
<p>
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void Server_Change(object sender, EventArgs e)
{
if (Radio1.Checked)
{
Span1.InnerHtml = "You selected " + Radio1.Value;
}
else if (Radio2.Checked)
{
Span1.InnerHtml = "You selected " + Radio2.Value;
}
else if (Radio3.Checked)
{
Span1.InnerHtml = "You selected " + Radio3.Value;
}
}
void Page_Load(object sender, EventArgs e)
{
// Create an EventHandler delegate for the method you want to
// handle the event, and then add it to the list of methods
// called when the event is raised.
Radio1.ServerChange += new System.EventHandler(this.Server_Change);
Radio2.ServerChange += new System.EventHandler(this.Server_Change);
Radio3.ServerChange += new System.EventHandler(this.Server_Change);
}
</script>
</head>
<body>
<form runat="server">
<h3>HtmlInputRadioButton ServerChange Example</h3>
<input type="radio"
id="Radio1"
name="Mode"
value="Radio Button 1"
runat="server"/>
Option 1
<br>
<input type="radio"
id="Radio2"
name="Mode"
value="Radio Button 2"
runat="server"/>
Option 2
<br>
<input type="radio"
id="Radio3"
name="Mode"
value="Radio Button 3"
runat="server"/>
Option 3
<p>
<input type="submit"
id="Button1"
value="Submit"
runat="server"/>
<p>
<span id="Span1"
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
HtmlInputRadioButton-Klasse
HtmlInputRadioButton-Member
System.Web.UI.HtmlControls-Namespace
ServerChange
System.EventArgs
Checked