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.
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