Freigeben über


RadioButton-Klasse

Stellt ein Optionsfeld-Steuerelement dar.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Class RadioButton
    Inherits CheckBox
    Implements IPostBackDataHandler
'Usage
Dim instance As RadioButton
public class RadioButton : CheckBox, IPostBackDataHandler
public ref class RadioButton : public CheckBox, IPostBackDataHandler
public class RadioButton extends CheckBox implements IPostBackDataHandler
public class RadioButton extends CheckBox implements IPostBackDataHandler

Hinweise

Das RadioButton-Serversteuerelement ermöglicht es Ihnen, die Optionsfelder auf der Seite in eine Gruppe mit anderen Inhalten einzufügen. Die Schaltflächen sind logisch gruppiert, sofern sie alle die gleiche GroupName-Eigenschaft gemeinsam verwenden.

Hinweis

Mit dem RadioButton-Steuerelement können Benutzereingaben angezeigt werden, die u. U. böswillige Clientskripts enthalten. Überprüfen Sie alle Informationen, die von einem Client gesendet werden, nach ausführbaren Skripts, SQL-Anweisungen oder anderem Code, bevor Sie sie in der Anwendung anzeigen. ASP.NET stellt ein Feature zur Anfragevalidierung von Eingaben bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Serversteuerelemente für die Validierung werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax von Validierungs-Serversteuerelementen.

Eingabehilfen

Das für dieses Steuerelement standardmäßig wiedergegebene Markup entspricht eventuell nicht den Standards für die Eingabehilfen wie beispielsweise den Richtlinien der Web Content Accessibility Guidelines 1.0 (WCAG) mit der Priorität 1. Details über die Unterstützung von Eingabehilfen für dieses Steuerelement finden Sie unter Steuerelemente und Eingabehilfen von ASP.NET.

Thema Position
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Arbeiten mit Cascading Stylesheet-Formaten in Visual Web Developer Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web Developer Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von RadioButtonList-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von RadioButton-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web Developer Erstellen von Anwendungen mit Visual Web Developer
Gewusst wie: Festlegen des Layouts in einem RadioButtonList-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen und Abrufen der Auswahl in einem RadioButton-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen des Fokus auf ein ASP.NET-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von RadioButtonList-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von RadioButton-Webserversteuerelementen zu einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf eine Benutzerauswahl in einer Gruppe von RadioButton-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen des Layouts in einem RadioButtonList-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen und Abrufen der Auswahl in einem RadioButton-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen des Fokus auf ein ASP.NET-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von RadioButtonList-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von RadioButton-Webserversteuerelementen zu einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf eine Benutzerauswahl in einer Gruppe von RadioButton-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen des Layouts in einem RadioButtonList-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Hinzufügen von RadioButtonList-Webserversteuerelementen zu einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Festlegen und Abrufen der Auswahl in einem RadioButton-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Hinzufügen einzelner RadioButton-Webserversteuerelemente zu einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Festlegen des Fokus auf ein ASP.NET-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Reagieren auf eine Benutzerauswahl in einer Gruppe von RadioButton-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Codebeispiel wird die Verwendung des RadioButton-Steuerelements veranschaulicht.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
 <head>
 
     <script language="VB" 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 runat="server" Text="Full" GroupName="RadioGroup1" /><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>
 
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <head>
 
     <script language="C#" 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>
 
     <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 runat="server" Text="Full" GroupName="RadioGroup1" /><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>
 

Vererbungshierarchie

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.CheckBox
        System.Web.UI.WebControls.RadioButton

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

RadioButton-Member
System.Web.UI.WebControls-Namespace
CheckBox-Klasse

Weitere Ressourcen

RadioButton- und RadioButtonList-Webserver-Steuerelemente