Freigeben über


RadioButton-Webserversteuerelement

Erstellt eine einzelne runde Optionsschaltfläche auf der Seite. Sie können mehrere runde Optionsschaltflächen zu einer Gruppe zusammenfassen, um Auswahlmöglichkeiten bereitzustellen, die sich gegenseitig ausschließen.

<asp:RadioButtonid="RadioButton1"      AutoPostBack="True|False"     Checked="True|False"     GroupName="GroupName"     Text="label"     TextAlign="Right|Left"     OnCheckedChanged="OnCheckedChangedMethod"     runat="server"/>

Hinweise

Das RadioButton-Serversteuerelement erstellt eine runde Optionsschaltfläche auf der Web Forms-Seite. Geben Sie den Text an, der in dem Steuerelement angezeigt werden soll, indem Sie die Text-Eigenschaft setzen. Der Text kann rechts oder links von der runden Optionsschaltfläche angezeigt werden. Setzen Sie die TextAlign-Eigenschaft, um anzugeben, auf welcher Seite der Text erscheinen soll. Sie können mehrere Optionsschaltflächen zu einer Gruppe zusammenfassen, wenn Sie für jedes RadioButton-Steuerelement den gleichen GroupName angeben. Dadurch schließen sich die die Optionen in der Gruppe gegenseitig aus.

Hinweis   Sie können auch das RadioButtonList-Steuerelement verwenden. Das RadioButtonList-Steuerelement eignet sich besser zum Erstellen einer Gruppe von runden Optionsschaltflächen mit Datenbindung, während Sie bei einem einzelnen RadioButton-Steuerelement mehr Möglichkeiten für die Layoutgestaltung haben.

Um zu ermitteln, ob das RadioButton-Steuerelement aktiviert ist, testen Sie die Checked-Eigenschaft.

Vorsicht   Text wird nicht in HTML codiert, bevor er im RadioButton-Steuerelement angezeigt wird. Auf diese Weise können Skripts in HTML-Tags in den Text eingebunden werden. Wenn die Werte in diesem Steuerelement aus Benutzereingaben stammen, müssen die Werte unbedingt geprüft werden, um die Sicherheit zu gewährleisten.

Weitere Informationen zu den Eigenschaften und Ereignissen des RadioButton-Webserversteuerelements finden Sie unter RadioButton-Klasse.

Beispiel

Das folgende Beispiel veranschaulicht, wie mit einem RadioButton-Steuerelement eine Gruppe von sich gegenseitig ausschließenden Optionen für den Benutzer bereitgestellt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
   <script runat="server">
      Sub SubmitBtn_Click(Sender As Object, e As EventArgs)
         If Radio1.Checked Then
            Label1.Text = "You selected " & Radio1.Text
         ElseIf Radio2.Checked Then
            Label1.Text = "You selected " & Radio2.Text
         ElseIf Radio3.Checked Then
            Label1.Text = "You selected " & Radio3.Text
         End If
      End Sub
   </script>
</head>
<body>
   <h3>RadioButton Example</h3>
   <form runat="server">
      <h4>Select the type of installation you want to perform:</h4>
      <asp:RadioButton id=Radio1 
           Text="Typical" 
           Checked="True" 
           GroupName="RadioGroup1" 
           runat="server" /><br>
      This option installs the features most typically used.
      <i>Requires 1.2 MB disk space.</i><p>
      <asp:RadioButton id=Radio2 
           Text="Compact" 
           GroupName="RadioGroup1" 
           runat="server"/><br>
      This option installs the minimum files required to run 
      the product.  <i>Requires 350 KB disk space.</i><p>
      <asp:RadioButton id=Radio3 
           Text="Full" 
           GroupName="RadioGroup1"  
           runat="server" /><br>
      This option installs all features for the product.  
      <i>Requires 4.3 MB disk space.</i><p>
      <asp:Button text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat=server/>
      <asp:Label id=Label1 
           Font-Bold="true" 
           runat="server" />
   </form>
</body>
</html>
[C#]
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
   <script runat="server">
      void SubmitBtn_Click(Object Sender, EventArgs e) 
      {
         if (Radio1.Checked) 
         {
            Label1.Text = "You selected " + Radio1.Text;
         }
         else if (Radio2.Checked) 
         {
            Label1.Text = "You selected " + Radio2.Text;
         }
         else if (Radio3.Checked) 
         {
            Label1.Text = "You selected " + Radio3.Text;
         }
      }
   </script>
</head>
<body>
   <form runat="server">
      <h3>RadioButton Example</h3>
      <h4>Select the type of installation you want to perform:</h4>
      <asp:RadioButton id="Radio1" 
           Text="Typical" 
           Checked="True" 
           GroupName="RadioGroup1" 
           runat="server" /><br>
      This option installs the features most typically used.  
      <i>Requires 1.2 MB disk space.</i><p>
      <asp:RadioButton id="Radio2" 
           Text="Compact" 
           GroupName="RadioGroup1" 
           runat="server"/><br>
      This option installs the minimum files required to run the product.  
      <i>Requires 350 KB disk space.</i><p>
      <asp:RadioButton id="Radio3"  
           Text="Full" 
           GroupName="RadioGroup1" 
           runat="server"/><br>
      This option installs all features for the product.  
      <i>Requires 4.3 MB disk space.</i><p>
      <asp:Button id="Button1" 
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat=server/>
      <asp:Label id="Label1" 
           Font-Bold="true" 
           runat="server" />
   </form>
</body>
</html>

Siehe auch

Webserversteuerelemente | RadioButton-Klasse