Übersicht über die RadioButton- und RadioButtonList-Webserversteuerelemente
Aktualisiert: November 2007
Das RadioButton-Steuerelement und das RadioButtonList-Steuerelement ermöglichen dem Benutzer das Treffen einer Auswahl aus einer kleinen Anzahl sich gegenseitig ausschließender, vordefinierter Möglichkeiten.
Dieses Thema enthält folgende Abschnitte:
Features
Background
Codebeispiele
Klassenreferenz
Features
Mit den Steuerelementen CheckBox und CheckBoxList kann:
Ein Postback der Seite auslösen, wenn ein Optionsfeld aktiviert wird.
Benutzerinteraktion aufzeichnen, wenn ein Benutzer ein Optionsfeld aktiviert.
Jedes Optionsfeld an Daten aus einer Datenbank binden.
Zurück nach oben
Background
Mit diesen beiden Typen von Webserversteuerelementen können Sie einer ASP.NET-Webseite Optionsfelder hinzufügen: einzelne RadioButton-Steuerelemente oder ein RadioButtonList-Steuerelement. Beide Steuerelemente ermöglichen dem Benutzer, eine Auswahl aus einer kleinen Gruppe sich gegenseitig ausschließender, vordefinierter Optionen zu treffen. Mithilfe dieser Steuerelemente können Sie eine beliebige Anzahl von bezeichneten Optionsfeldern definieren und diese horizontal oder vertikal anordnen.
RadioButton-Steuerelemente werden einer Seite einzeln hinzugefügt und als unabhängige Elemente angesehen. In der Regel werden zwei oder mehr Einzelschaltflächen gruppiert.
Wahlweise können Sie auch das RadioButtonList-Steuerelement verwenden. Dies ist ein einzelnes Steuerelement, das als übergeordnetes Steuerelement für eine Auflistung von Optionsfeld-Listenelementen verwendet wird. Es wird von der ListControl-Basisklasse abgeleitet. Es verfügt daher über ähnliche Funktionen wie die Webserversteuerelemente ListBox, DropDownList, BulletedList und CheckBoxList. Viele der Verfahren für die Verwendung des RadioButtonList-Steuerelements stimmen mit den Verfahren für die anderen List-Webserversteuerelemente überein.
Beide Typen von Steuerelementen haben Vorteile. Mit einzelnen RadioButton-Steuerelementen kann das Layout der Optionsfeldgruppe besser gestaltet werden als mit dem RadioButtonList-Steuerelement. So können Sie beispielsweise Text (keinen Optionsfeldtext) zwischen den Optionsfeldern einfügen.
Das RadioButtonList-Steuerelement ist besser geeignet, wenn Sie eine Optionsfeldgruppe auf Grundlage von Daten aus einer Datenquelle erstellen möchten. Es ist auch leichter, Code zu schreiben, mit dem bestimmt wird, welches Optionsfeld aktiviert wurde.
.gif "Hinweis") Hinweis: |
|---|
Mithilfe des HtmlInputRadioButton-Serversteuerelements können Sie auch Optionsfelder auf einer ASP.NET-Webseite hinzufügen. Weitere Informationen hierzu finden Sie unter Deklarative Syntax des HtmlInputRadioButton-Serversteuerelements. |
Um Benutzern eine längere Optionsliste anzubieten oder eine Liste, deren Länge zur Laufzeit variabel ist, verwenden Sie ein ListBox-Webserversteuerelement oder ein DropDownList-Webserversteuerelement.
Gruppieren von Optionsfeldern
Optionsfelder werden nur selten einzeln verwendet. Zumeist sind sie in Gruppen zusammengefasst und bieten so eine Reihe sich gegenseitig ausschließender Optionen. Innerhalb einer Gruppe kann jeweils nur ein Optionsfeld aktiviert werden. Gruppierte Optionsfelder können wie folgt erstellt werden:
Fügen Sie einer Seite einzelne RadioButton-Webserversteuerelemente hinzu, und weisen Sie diese dann manuell einer Gruppe zu. Der Gruppenname ist beliebig. Alle Optionsfelder mit dem gleichen Gruppennamen werden als Bestandteil einer einzelnen Gruppe angesehen.
Fügen Sie der Seite ein RadioButtonList-Webserversteuerelement hinzu. Die Listenelemente im Steuerelement werden automatisch gruppiert.
RadioButton-Ereignisse und RadioButtonList-Ereignisse
Im Hinblick auf die Ereignisbehandlung weisen die einzelnen RadioButton-Steuerelemente und das RadioButtonList-Steuerelement Unterschiede auf.
Einzelne RadioButton-Steuerelemente
Einzelne RadioButton-Steuerelemente lösen das CheckedChanged-Ereignis aus, wenn Benutzer auf das Steuerelement klicken. (Dieses Ereignis wird vom CheckBox-Steuerelement geerbt.) In der Standardeinstellung führt das Ereignis nicht dazu, dass die Seite auf dem Server bereitgestellt wird. Sie können ein sofortiges Postback durch das Steuerelement jedoch erzwingen, indem Sie die AutoPostBack-Eigenschaft auf true festlegen. Ausführliche Informationen dazu, wie Sie direkt auf dieses Ereignis reagieren können, finden Sie unter Gewusst wie: Reagieren auf eine Benutzerauswahl in einer Gruppe von RadioButton-Webserversteuerelementen.
| Hinweis: |
|---|
Für die automatische Postbackfunktion muss der Browser ECMAScript (Jscript oder JavaScript) unterstützen und die Skriptausführung muss im Browser des Benutzers aktiviert sein. |
Möglicherweise müssen Sie einen Ereignishandler für das CheckedChanged-Ereignis erstellen. Sie können in jedem als Teil der Seite ausgeführten Code überprüfen, welches Optionsfeld ausgewählt ist. Sie erstellen in der Regel nur dann einen Ereignishandler für das CheckedChanged-Ereignis, wenn neben der aktuellen Auswahl auch Änderungen an Optionsfeldern abgerufen werden müssen. Weitere Informationen finden Sie unter Gewusst wie: Festlegen und Abrufen der Auswahl in einem RadioButton-Webserversteuerelement.
RadioButtonList-Steuerelement
Das RadioButtonList-Steuerelement löst ein SelectedIndexChanged-Ereignis aus, wenn der Benutzer ein anderes Optionsfeld in der Liste auswählt. In der Standardeinstellung führt das Ereignis nicht dazu, dass die Seite auf dem Server bereitgestellt wird. Sie können ein sofortiges Postback durch das Steuerelement jedoch erzwingen, indem Sie die AutoPostBack-Eigenschaft auf true festlegen. Weitere Informationen finden Sie unter Gewusst wie: Reagieren auf Änderungen in List-Webserversteuerelementen.
| Hinweis: |
|---|
Für die automatische Postbackfunktion muss der Browser ECMAScript (Jscript oder JavaScript) unterstützen und die Skriptausführung muss im Browser des Benutzers aktiviert sein. |
Genau wie bei einzelnen RadioButton-Steuerelementen wird der Zustand des RadioButtonList-Steuerelements in der Regel erst überprüft, nachdem die Seite auf andere Weise bereitgestellt wurde. Weitere Informationen finden Sie unter Gewusst wie: Bestimmen der Auswahl in List-Webserversteuerelementen.
HTML-Attribute des RadioButton-Steuerelements
Das RadioButton-Steuerelement wird im Browser in zwei Komponenten gerendert: ein input-Element zur Darstellung des Optionsfelds, und ein separates label-Element für dessen Beschriftung. Beide Elemente sind wiederum von einem span-Element umschlossen.
Wenn Sie einem RadioButton-Steuerelement Format- oder Attributeinstellungen zuweisen, werden diese Einstellungen auf das äußere span-Element angewendet. Wenn Sie beispielsweise die BackColor-Eigenschaft des Steuerelements festgelegt haben, wird diese Einstellung für das span-Element übernommen. Die Einstellung gilt daher für beide inneren Elemente (input und label).
Manchmal ist es erforderlich, unterschiedliche Einstellungen für das Optionsfeld und dessen Bezeichnung vornehmen zu können. Das RadioButton-Steuerelement unterstützt zwei Eigenschaften, die zur Laufzeit festgelegt werden können. Mithilfe der InputAttributes-Eigenschaft können Sie dem input-Element HTML-Attribute hinzufügen, und mit der LabelAttributes-Eigenschaft können Sie dem label-Element HTML-Attribute hinzufügen. Die festgelegten Attribute werden so, wie sie sind, an den Browser übergeben. Im folgenden Beispiel wird dargestellt, wie die Attribute für das input-Element festgelegt werden müssen, damit sich nur die Farbe des Optionsfelds, nicht jedoch die Farbe der Bezeichnung ändert, wenn der Benutzer den Mauszeiger darüber bewegt.
RadioButton1.InputAttributes.Add("onmouseover", _
"this.style.backgroundColor = 'red'")
RadioButton1.InputAttributes.Add("onmouseout", _
"this.style.backgroundColor = 'white'")
RadioButton1.InputAttributes.Add("onmouseover",
"this.style.backgroundColor = 'red'");
RadioButton1.InputAttributes.Add("onmouseout",
"this.style.backgroundColor = 'white'");
Binden von Daten an das Steuerelement
Sie können ein einzelnes RadioButton-Steuerelement an eine Datenquelle binden. Außerdem kann jede Eigenschaft des RadioButton-Steuerelements an ein beliebiges Feld der Datenquelle gebunden werden. Beispielsweise können Sie die Text-Eigenschaft des Steuerelements auf Grundlage von Daten aus einer Datenbank festlegen.
Da Optionsfelder in Gruppen verwendet werden, wird ein einzelnes Optionsfeld nur selten an eine Datenquelle gebunden. Stattdessen kommt es häufiger vor, dass ein RadioButtonList-Steuerelement an eine Datenquelle gebunden wird. In diesem Fall generiert die Datenquelle für jeden Datensatz in der Datenquelle dynamisch Optionsfelder (Listenelemente).
Zurück nach oben
Codebeispiele
Gewusst wie: Hinzufügen von RadioButton-Webserversteuerelementen zu einer Web Forms-Seite
Gewusst wie: Festlegen und Abrufen der Auswahl in einem RadioButton-Webserversteuerelement
Gewusst wie: Festlegen des Layouts in einem RadioButtonList-Webserversteuerelement
Gewusst wie: Hinzufügen von Elementen zu List-Webserversteuerelementen (Visual Studio)
Gewusst wie: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle (Visual Studio)
Gewusst wie: Reagieren auf Änderungen in List-Webserversteuerelementen
Zurück nach oben
Klassenreferenz
In der folgenden Tabelle sind die Klassen aufgelistet, die sich auf die Steuerelemente RadioButton und RadioButtonList beziehen.
Member |
Beschreibung |
|---|---|
Die Hauptklasse für das RadioButton-Steuerelement. |
|
Die Hauptklasse für das RadioButtonList-Steuerelement. |
|
Die Klasse, die jedes Element des RadioButtonList-Steuerelements darstellt. |
|
Die Auflistung von Elementen, die einzelnen Elementen in der Liste für ein RadioButtonList-Steuerelement entsprechen. |
Zurück nach oben
Siehe auch
Aufgaben
Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen (Visual Studio)
Gewusst wie: Bestimmen der Auswahl in List-Webserversteuerelementen
Referenz
Übersicht über die CheckBox-Webserversteuerelemente und CheckBoxList-Webserversteuerelemente