8.13 RadioButton
 
| Klasse
|
System.Web.UI.WebControls.RadioButton
|
| Deklaration
|
<asp:RadioButton id="RadioButton1"
AutoPostBack="True|False"
Checked="True|False"
GroupName="GroupName"
Text="Beschriftung"
TextAlign="Right|Left"
OnCheckedChanged="OnCheckedChanged-Methode"
runat="server"/>
|
| Erzeugter HTML-Code
|
<input type="radio" value=" Inhalt vom id-Attribut " checked=" Inhalt vom Checked-Attribut " ... /><label for=" Inhalt vom id-Attribut ">Text-Attribut</label>
|
| Kurzcharakteristik
|
Das RadioButton-Steuerelement erzeugt ein beschriftetes Optionsfeld. Mehrere Optionsfelder werden zu einer Gruppe sich gegenseitig ausschließender Optionen zusammengefasst, indem ihr Attribut GroupName den gleichen Wert erhält.
|
webserver_radiobutton01.aspx bietet dem Anwender die Möglichkeit, einen Radiosender auszuwählen. Durch die aktivierte AutoPostBack-Eigenschaft wird das OnCheckedChanged-Ereignis sofort nach der Auswahl des Anwenders vom Server verarbeitet, jedenfalls sofern im Browser JavaScript aktiviert ist. Ansonsten muss der Anwender noch eigens den OK-Button anklicken. Abbildung 8.8 zeigt die Darstellung im Browser.
<!-- webserver_radiobutton01.aspx -->
<%@ Page Language="VB" debug="True" Strict="True" %>
<script runat="server" >
Sub radioauswahl (ByVal Sender As Object, _
ByVal E As EventArgs)
Dim t As String = ""
If radio1.Checked Then
t = "NDR2: ""An der Nordseeküste ..."""
ausgabe.text = t
Else If radio2.Checked Then
t ="WDR 2: ""... die Hitparade "
t += "aus dem Kölner Funkhaus!"""
ausgabe.text = t
Else If radio3.Checked Then
t = "SWR 3: ""Achtung, Verkehrsfunk: Durch "
t += "Baden-Baden läuft ein Schwarzwald-Elch!"""
ausgabe.text = t
End If
End Sub
</script>
<html><head>
<title>Webserversteuerelemente: RadioButton</title>
</head><body>
<h3>Welchen Sender wollen Sie hören?</h3>
<form runat="server" id="myForm">
<asp:RadioButton id="radio1" runat="server"
AutoPostBack="True"
Checked="False"
GroupName="Sender"
Text="NDR 2"
TextAlign="Right"
OnCheckedChanged ="radioauswahl" /><br>
<asp:RadioButton id="radio2" runat="server"
AutoPostBack="True"
Checked="False"
GroupName="Sender"
Text="WDR 2"
TextAlign="Right"
OnCheckedChanged ="radioauswahl" /><br>
<asp:RadioButton id="radio3" runat="server"
AutoPostBack="True"
Checked="False"
GroupName="Sender"
Text="SWR 3"
TextAlign="Right"
OnCheckedChanged ="radioauswahl" />
<br><br>
<asp:Button id="btnOK" runat="server"
Text=" OK " />
<br><br>
<asp:Label id="ausgabe" runat="server" />
</form></body></html>
Die RadioButton-Klasse ist direkt von der CheckBox-Klasse abgeleitet. Im Vergleich zur CheckBox-Klasse fügt sie nur eine einzige Eigenschaft neu hinzu: GroupName. Die drei Optionsfelder des Beispiels haben alle das Attribut GroupName="Sender" erhalten. Dadurch werden diese Optionsfelder zu einer einheitlichen Gruppe zusammengefasst, deren Selektion sich gegenseitig ausschließt. Erst dadurch entsteht das charakteristische Verhalten dieses Steuerelements.
 Hier klicken, um das Bild zu Vergrößern
Abbildung 8.8 Die RadioButton-Klasse ist von der CheckBox-Klasse abgeleitet und fügt lediglich das GroupName-Attribut hinzu.
|