HtmlInputRadioButton-Klasse
Ermöglicht den programmgesteuerten Zugriff auf das HTML-<input type= radio>-Element auf dem Server.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class HtmlInputRadioButton
Inherits HtmlInputControl
Implements IPostBackDataHandler
'Usage
Dim instance As HtmlInputRadioButton
public class HtmlInputRadioButton : HtmlInputControl, IPostBackDataHandler
public ref class HtmlInputRadioButton : public HtmlInputControl, IPostBackDataHandler
public class HtmlInputRadioButton extends HtmlInputControl implements IPostBackDataHandler
public class HtmlInputRadioButton extends HtmlInputControl implements IPostBackDataHandler
Hinweise
Verwenden Sie das HtmlInputRadioButton-Steuerelement, um auf einer Webseite ein Optionsfeld zu erstellen. Das HtmlInputRadioButton-Steuerelement stellt keine integrierten Funktionen zum Anzeigen einer Beschriftung für das Optionsfeld bereit. Sie können eine Beschriftung erstellen, indem Sie auf der Webseite an der gewünschten Position literalen Text verwenden. Auf diese Weise können Sie festlegen, wo die Beschriftung relativ zum Optionsfeld angezeigt werden soll. Wenn die Beschriftung z. B. rechts neben dem Optionsfeld angezeigt werden soll, deklarieren Sie ein HtmlInputRadioButton-Steuerelement, dem der Beschriftungstext folgt, wie im folgenden Codebeispiel dargestellt.
<input type="radio"
id="Radio1"
name="Mode"
runat="server"/>
Caption Text<br>
Sie können dem HtmlInputRadioButton-Steuerelement bei Bedarf auch eine Menge zuordnen, indem Sie die Value-Eigenschaft festlegen. Das ist von Vorteil, wenn mehrere Optionsfelder vorhanden sind und auf der Grundlage der Auswahl eine Berechnung auszuführen ist.
HtmlInputRadioButton-Steuerelemente können in Gruppen zusammengefasst werden, indem Sie für die Name-Eigenschaft jedes in die Gruppe aufzunehmenden Optionsfelds einen gemeinsamen Wert angeben.
Hinweis
Wenn Sie HtmlInputRadioButton-Steuerelemente in einer Gruppe zusammenfassen, kann immer nur jeweils ein Optionsfeld der Gruppe ausgewählt werden.
Durch Überprüfen der Checked-Eigenschaft können Sie ermitteln, welches HtmlInputRadioButton-Steuerelement ausgewählt ist. Bei einer Gruppe von HtmlInputRadioButton-Steuerelementen müssen die Steuerelemente durchlaufen werden, und für jedes Steuerelement muss die Checked-Eigenschaft einzeln überprüft werden.
Das HtmlInputRadioButton-Steuerelement stellt ein ServerChange-Ereignis bereit, das ausgelöst wird, wenn der Wert der Checked-Eigenschaft 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).
Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von HtmlInputRadioButton finden Sie unter HtmlInputRadioButton-Konstruktor.
| Thema | Position |
|---|---|
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit dem HtmlInputRadioButton-Steuerelement eine Gruppe von Optionsfeldern erstellt wird.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script language="VB" runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
If Radio1.Checked = True Then
Span1.InnerHtml = "Option 1 is selected"
Else
If Radio2.Checked = True Then
Span1.InnerHtml = "Option 2 is selected"
Else
If Radio3.Checked = True Then
Span1.InnerHtml = "Option 3 is selected"
End If
End If
End If
End Sub 'Button1_Click
</script>
</head>
<body>
<form runat=server>
<h3>HtmlInputRadioButton Sample</h3>
<input type="radio"
id="Radio1"
name="Mode"
runat="server"/>
Option 1<br>
<input type="radio"
id="Radio2"
name="Mode"
runat="server"/>
Option 2<br>
<input type="radio"
id="Radio3"
name="Mode"
runat="server"/>
Option 3
<p>
<span id="Span1" runat="server" />
<p>
<input type="button"
id="Button1"
value="Enter"
OnServerClick="Button1_Click"
runat="server">
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script language="C#" runat="server">
void Button1_Click(object sender, EventArgs e)
{
if (Radio1.Checked == true)
Span1.InnerHtml = "Option 1 is selected";
else if (Radio2.Checked == true)
Span1.InnerHtml = "Option 2 is selected";
else if (Radio3.Checked == true)
Span1.InnerHtml = "Option 3 is selected";
}
</script>
</head>
<body>
<form runat=server>
<h3>HtmlInputRadioButton Sample</h3>
<input type="radio"
id="Radio1"
name="Mode"
runat="server"/>
Option 1<br>
<input type="radio"
id="Radio2"
name="Mode"
runat="server"/>
Option 2<br>
<input type="radio"
id="Radio3"
name="Mode"
runat="server"/>
Option 3
<p>
<span id="Span1" runat="server" />
<p>
<input type="button"
id="Button1"
value="Enter"
OnServerClick="Button1_Click"
runat="server">
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>
<script language="JSCRIPT" runat="server">
function Button1_Click(sender : Object, e : EventArgs){
if(Radio1.Checked)
Span1.InnerHtml = "Option 1 is selected"
else if(Radio2.Checked)
Span1.InnerHtml = "Option 2 is selected"
else if(Radio3.Checked)
Span1.InnerHtml = "Option 3 is selected"
}
</script>
</head>
<body>
<form runat=server>
<h3>HtmlInputRadioButton Sample</h3>
<input type="radio"
id="Radio1"
name="Mode"
runat="server"/>
Option 1<br>
<input type="radio"
id="Radio2"
name="Mode"
runat="server"/>
Option 2<br>
<input type="radio"
id="Radio3"
name="Mode"
runat="server"/>
Option 3
<p>
<span id="Span1" runat="server" />
<p>
<input type="button"
id="Button1"
value="Enter"
OnServerClick="Button1_Click"
runat="server">
</form>
</body>
</html>
.NET Framework-Sicherheit
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.HtmlControls.HtmlControl
System.Web.UI.HtmlControls.HtmlInputControl
System.Web.UI.HtmlControls.HtmlInputRadioButton
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
HtmlInputRadioButton-Member
System.Web.UI.HtmlControls-Namespace
HtmlInputControl.Name-Eigenschaft
Value
Checked
ServerChange
HtmlInputCheckBox-Klasse