Übersicht über die CheckBox-Webserversteuerelemente und CheckBoxList-Webserversteuerelemente
Aktualisiert: November 2007
Mit den Steuerelementen CheckBox und CheckBoxList kann Benutzern die Eingabe einer Ja/Nein (Wahr/Falsch)-Auswahl ermöglicht werden.
Dieses Thema enthält folgende Abschnitte:
Features
Hintergrund
Codebeispiele
Klassenreferenz
Features
Mit den Steuerelementen CheckBox und CheckBoxList kann:
Ein Seiten-Postback bei Aktivierung eines Kontrollkästchens hervorgerufen werden.
Benutzerinteraktion aufgezeichnet werden, wenn ein Benutzer ein Kontrollkästchen aktiviert.
Ein Kontrollkästchen an Daten in einer Datenbank gebunden werden.
Zurück nach oben
Hintergrund
Sie können zwei verschiedene Arten von Webserversteuerelementen verwenden, um einer ASP.NET-Webseite Kontrollkästchen hinzuzufügen: einzelne CheckBox-Steuerelemente oder ein CheckBoxList-Steuerelement. Beide Steuerelemente bieten Benutzern die Möglichkeit, eine Ja/Nein (Wahr/Falsch)-Auswahl zu treffen.
CheckBox-Steuerelemente werden einer Seite einzeln hinzugefügt und als unabhängige Elemente angesehen. Wahlweise können Sie auch das CheckBoxList-Steuerelement verwenden. Dies ist ein einzelnes Steuerelement, das als übergeordnetes Steuerelement für eine Auflistung von Kontrollkästchen-Listenelementen dient. Da dieses Steuerelement von einer ListControl-Basisklasse abgeleitet ist, weist es ähnliche Funktionen wie die Webserversteuerelemente ListBox, DropDownList, RadioButtonList und BulletedList auf. Zahlreiche Verfahrensweisen für die Verwendung des CheckBoxList-Steuerelements stimmen mit denen für die anderen Listen-Webserversteuerelemente überein.
Beide Typen von Steuerelementen haben Vorteile. Durch die Verwendung einzelner CheckBox-Steuerelemente lässt sich das Layout der auf einer Seite enthaltenen Kontrollkästchen besser gestalten als mit dem CheckBoxList-Steuerelement. So können Sie beispielsweise Text, der kein Kontrollkästchentext ist, zwischen den einzelnen Kontrollkästchen einfügen. Darüber hinaus können auch Schriftart und Farbe einzelner Kontrollkästchen gestaltet werden.
Die Verwendung des CheckBoxList-Steuerelements empfiehlt sich, wenn Sie mehrere Kontrollkästchen auf der Grundlage von Daten in einer Datenquelle erstellen möchten. (Natürlich kann auch ein einzelnes CheckBox-Steuerelement an Daten gebunden werden.)
.gif "Hinweis") Hinweis: |
|---|
Mit dem HtmlInputCheckBox-Steuerelement können Sie ebenfalls Kontrollkästchen zu einer ASP.NET-Webseite hinzufügen. Weitere Informationen finden Sie unter Deklarative Syntax des HtmlInputCheckBox-Serversteuerelements. |
CheckBox-Ereignisse und CheckBoxList-Ereignisse
Im Hinblick auf die Ereignisbehandlung weisen die einzelnen CheckBox-Steuerelemente und das CheckBoxList-Steuerelement Unterschiede auf.
CheckBox-Steuerelementereignisse
Einzelne CheckBox-Steuerelemente lösen das CheckedChanged-Ereignis aus, wenn Benutzer auf das Steuerelement klicken. 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 eine Benutzerauswahl in einem CheckBox-Webserversteuerelement.
| 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 keinen Ereignishandler für das CheckedChanged-Ereignis erstellen. Sie können in jedem als Teil der Seite ausgeführten Code überprüfen, welches Kontrollkästchen ausgewählt wurde. Sie erstellen in der Regel nur dann einen Ereignishandler für das CheckedChanged-Ereignis, wenn Sie wissen möchten, ob der Zustand des Kontrollkästchens geändert wurde, und nicht einfach nur um seinen Wert auszulesen. Ausführliche Informationen finden Sie unter Gewusst wie: Festlegen und Abrufen der Auswahl in einem RadioButton-Webserversteuerelement.
CheckBoxList-Steuerelementereignisse
Das CheckBoxList-Steuerelement löst ein SelectedIndexChanged-Ereignis aus, wenn der Benutzer ein beliebiges Kontrollkästchen in der Liste aktiviert. 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.
| 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 CheckBox-Steuerelementen wird der Zustand des CheckBoxList-Steuerelements in der Regel erst überprüft, nachdem die Seite auf andere Weise bereitgestellt wurde. Ausführliche Informationen finden Sie unter Gewusst wie: Bestimmen der Auswahl in List-Webserversteuerelementen.
HTML-Attribute von CheckBox-Steuerelementen
Das CheckBox-Steuerelement wird in Form von zwei Teilen im Browser gerendert: ein input-Element zur Darstellung des Kontrollkästchens und ein separates label-Element für dessen Beschriftung. Beide Elemente sind wiederum in einem span-Element eingeschlossen.
Wenn Sie einem CheckBox-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. Deshalb wirkt sie sich auf die beiden inneren Elemente (input und label) aus.
Manchmal ist es erforderlich, unterschiedliche Einstellungen für das Kontrollkästchen und seine Bezeichnung festzulegen. Das CheckBox-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. Mithilfe 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 gezeigt, wie die Attribute für das input-Element festzulegen sind, damit sich nur die Farbe des Kontrollkästchens, nicht jedoch die der Bezeichnung ändert, wenn der Benutzer den Mauszeiger darüber bewegt.
[Visual Basic]
CheckBox1.InputAttributes.Add("onmouseover", _
"this.style.backgroundColor = 'red'")
CheckBox1.InputAttributes.Add("onmouseout", _
"this.style.backgroundColor = 'white'")
CheckBox1.InputAttributes.Add("onmouseover",
"this.style.backgroundColor = 'red'");
CheckBox1.InputAttributes.Add("onmouseout",
"this.style.backgroundColor = 'white'");
Binden von Daten an Steuerelemente
Sie können ein einzelnes CheckBox-Steuerelement an eine Datenquelle binden. Außerdem kann jede Eigenschaft des CheckBox-Steuerelements an ein beliebiges Feld der Datenquelle gebunden werden. Beispielsweise ist es üblich, die Checked-Eigenschaft des Steuerelements anhand von Datenbankinformationen festzulegen.
Auch CheckBoxList-Steuerelemente können an eine Datenquelle gebunden werden. In diesem Fall entspricht jedes Kontrollkästchen einem anderen Datensatz in der Datenquelle.
Zurück nach oben
Codebeispiele
Gewusst wie: Festlegen des Layouts in einem CheckBoxList-Webserversteuerelement
Gewusst wie: Programmgesteuertes Abrufen und Festlegen eines CheckBox-Webserversteuerelements
Gewusst wie: Reagieren auf eine Benutzerauswahl in einem CheckBox-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 CheckBox und CheckBoxList beziehen.
Member |
Beschreibung |
|---|---|
Die Hauptklasse für das CheckBox-Steuerelement. |
|
Die Hauptklasse für das CheckBoxList-Steuerelement. |
|
Die Klasse, die jedes Element des CheckBoxList-Steuerelements darstellt. |
|
Die Auflistung von Elementen, die einzelnen Elementen in der Liste für ein CheckBoxList-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 RadioButton- und RadioButtonList-Webserversteuerelemente