Einführung in RadioButton- und RadioButtonList-Webserversteuerelemente

Sie können zwei verschiedene Arten von Webserversteuerelementen verwenden, um einer Web Forms-Seite Optionsfelder hinzuzufügen: einzelne RadioButton-Steuerelemente oder ein einziges RadioButtonList-Steuerelement. Beide Steuerelemente ermöglichen es dem Benutzer, eine Auswahl aus einer kleinen Gruppe sich gegenseitig ausschließender, vordefinierter Optionen zu treffen. Bei Verwendung dieser Steuerelemente können Sie eine beliebige Anzahl von Optionsfeldern mit Beschriftungen definieren und diese horizontal oder vertikal anordnen.

**Hinweis   **Optionsfelder können einer Web Forms-Seite auch mit Hilfe des HtmlInputRadioButton-Serversteuerelements hinzugefügt werden. Einzelheiten zu den Unterschieden zwischen Web- und HTML-Steuerelementen finden Sie unter Einführung in ASP.NET-Serversteuerelemente.

**Tipp   **Um Benutzern eine längere Liste mit Optionen oder eine Liste, deren Umfang zur Laufzeit variiert, zur Verfügung zu stellen, verwenden Sie ein ListBox- oder DropDownList-Webserversteuerelement.

Vergleich zwischen RadioButton-Steuerelement und RadioButtonList-Steuerelement

RadioButton-Steuerelemente werden einer Seite einzeln hinzugefügt und als unabhängige Elemente angesehen. In der Regel werden zwei oder mehr Einzelschaltflächen gruppiert. Informationen dazu finden Sie unter Hinzufügen einzelner RadioButton-Steuerelemente zu einer Web Forms-Seite.

Das RadioButtonList-Steuerelement ist hingegen ein einzelnes Steuerelement, das als übergeordnetes Element für eine Gruppe von Optionsfeld-Listenelementen fungiert. Da dieses Steuerelement von einer ListControl-Klasse abgeleitet ist, weist es ähnliche Funktionen wie die Webserversteuerelemente ListBox, DropDownList und CheckBoxList auf. Daher sind zahlreiche Verfahrensweisen in Zusammenhang mit der Verwendung des RadioButtonList-Steuerelements identisch mit den Erläuterungen zu anderen List-Webserversteuerelementen.

Jeder Steuerelementtyp hat seine Vorteile. Mit einzelnen RadioButton-Steuerelementen lässt sich das Layout der Optionsfeldgruppe besser gestalten. So können Sie beispielsweise Text (keinen Optionsfeldtext) zwischen den einzelnen Optionsfeldern einfügen.

Bei Verwendung des RadioButtonList-Steuerelements können Sie zwar keinen Text zwischen den Optionsfeldern einfügen, doch ist die Bindung der Optionsfelder an eine Datenquelle sehr viel einfacher. Es ist auch leichter, Code zu schreiben, mit dem geprüft wird, welches Optionsfeld aktiviert wurde.

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. In diesem Fall hat die Gruppe einen willkürlich ausgewählten Namen, und alle Optionsfelder mit dem gleichen Gruppennamen werden als Bestandteil einer einzigen Gruppe angesehen.
• Fügen Sie der Seite ein RadioButtonList-Webserversteuerelement hinzu. Die Listenelemente im Steuerelement werden automatisch gruppiert.

RadioButton-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 ein Ereignis – CheckedChanged – aus, wenn der Benutzer auf das Steuerelement klickt. Normalerweise führt dieses Ereignis nicht dazu, dass die Seite auf dem Server bereitgestellt wird. Sie können eine sofortige Bereitstellung jedoch durch das Steuerelement erzwingen, indem Sie die AutoPostBack-Eigenschaft auf true setzen. Ausführliche Informationen dazu, wie Sie direkt auf dieses Ereignis reagieren können, finden Sie unter Reagieren auf eine Benutzerauswahl in einer Optionsfeldgruppe.

**Hinweis   **Damit das RadioButton-Steuerelement in der Lage ist, bei dessen Aktivierung Seiten auf dem Server bereitzustellen, muss der Browser ECMAScript (JScript, JavaScript) unterstützen, und die Skripterstellung muss im Browser des Benutzers aktiviert sein.

Es ist normalerweise nicht erforderlich, einen Ereignishandler für das CheckedChanged-Ereignis zu erstellen, und zwar unabhängig davon, ob ein RadioButton-Steuerelement ein Formular an den Server übermittelt oder nicht. Die Optionsfeldauswahl wird in der Regel erst überprüft, wenn das Formular von einem Steuerelement, z. B. dem Button-Steuerelement, auf dem Server bereitgestellt wurde. Ausführliche Informationen finden Sie unter Festlegen und Abrufen der Auswahl in einem RadioButton-Webserversteuerelement.

RadioButtonList-Steuerelement

Das RadioButtonList-Steuerelement löst hingegen ein SelectedIndexChanged-Ereignis aus, wenn der Benutzer die Auswahl des Optionsfeldes in der Liste ändert. Normalerweise führt dieses Ereignis nicht dazu, dass das Formular auf dem Server bereitgestellt wird. Sie können diese Option jedoch aktivieren, indem Sie die AutoPostBack-Eigenschaft auf true setzen. Ausführliche Informationen finden Sie unter Reagieren auf Änderungen in einem List-Webserversteuerelement.

**Hinweis   **Damit das RadioButtonList-Steuerelement in der Lage ist, bei dessen Aktivierung Seiten auf dem Server bereitzustellen, muss der Browser ECMAScript (JScript, JavaScript) unterstützen, und die Skripterstellung muss im Browser des Benutzers aktiviert sein.

Genauso wie bei einzelnen RadioButton-Steuerelementen wird der Zustand des RadioButtonList-Steuerelements in der Regel erst überprüft, nachdem das Formular auf andere Weise bereitgestellt wurde. Ausführliche Informationen finden Sie unter Bestimmen der Auswahl in einem List-Webserversteuerelement.

Binden von Daten an das Steuerelement

Wie alle Webserversteuerelemente kann auch ein einzelnes RadioButton-Steuerelement an eine Datenquelle gebunden werden. 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 anhand von Datenbankinformationen definieren.

Da Optionsfelder jedoch in Gruppen verwendet werden, wird ein einzelnes Optionsfeld nur selten an eine Datenquelle gebunden. Es kommt 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).

Allgemeine Informationen zur Datenbindung finden Sie unter Datenbindung von einwertigen Webserversteuerelementen zur Entwurfszeit.

Siehe auch

Hinzufügen von Webserversteuerelementen zu einer Web Forms-Seite | Einführung in die Überprüfung der Benutzereingabe in Web Forms | Programmgesteuertes Festlegen von Eigenschaften für Webserversteuerelemente | Anpassen des Erscheinungsbilds von ASP.NET-Serversteuerelementen mit Formatvorlagen | Web Forms-Statusverwaltung | Angeben, ob Steuerelemente an den Server übermitteln