ASP.NET CheckBoxListControl


Web Server ControlsWebserver-Steuerelement

Definition und Verwendung

Das CheckBoxList-Steuerelement wird verwendet, um eine Gruppe von Kontrollkästchen mit Mehrfachauswahl zu erstellen.

Die auswählbaren Elemente in jedem CheckBoxList-Steuerelement werden durch ListItem-Elemente definiert!

Tipp:Dieses Steuerelement unterstützt Datenbindung!


Eigenschaften

Eigenschaften Beschreibung .NET
CellPadding Die Anzahl der Pixel zwischen dem Rand und dem Inhalt der Tabellenzelle. 1.0
CellSpacing Die Anzahl der Pixel zwischen Tabellenzellen. 1.0
RepeatColumns Die Anzahl der Spalten, die beim Anzeigen der Kontrollkästchengruppe verwendet werden. 1.0
RepeatDirection Gibt an, ob die Kontrollkästchengruppe horizontal oder vertikal wiederholt wird. 1.0
RepeatLayout Das Layout der Kontrollkästchengruppe. 1.0
runat Gibt an, ob das Steuerelement ein Serversteuerelement ist. Muss auf "server" gesetzt werden. 1.0
TextAlign Auf welcher Seite des Kontrollkästchens der Text erscheint. 1.0

ListControl-Standardeigenschaften

AppendDataBoundItems, AutoPostBack, CausesValidation, DataTextField, DataTextFormatString, DataValueField, Items, runat, SelectedIndex, SelectedItem, SelectedValue, TagKey, Text, ValidationGroup, OnSelectedIndexChanged

Das ListControl-Steuerelement enthält alle grundlegenden Funktionen von Listensteuerelementen. Zu den Steuerelementen, die von diesem Steuerelement erben, gehören: CheckBoxList-, DropDownList-, ListBox- und RadioButtonList-Steuerelemente.

Eine vollständige Beschreibung finden Sie unterListControl-Standardeigenschaften。

Standardeigenschaften von Websteuerelementen

AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width

Eine vollständige Beschreibung finden Sie unterStandardeigenschaften von Websteuerelementen。

Standardeigenschaften von Steuerelementen

AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible

Eine vollständige Beschreibung finden Sie unterStandardeigenschaften von Steuerelementen。


Beispiel

CheckBoxList
In diesem Beispiel deklarieren wir ein CheckBoxList-Steuerelement in einer .aspx-Datei. Dann erstellen wir einen Ereignishandler für das SelectedIndexChanged-Ereignis. Diese Auswahlliste enthält sechs Kontrollkästchen. Wenn der Benutzer eines davon auswählt, führt die Seite automatisch ein Postback an den Server aus und führt die Subroutine Check aus. Die Subroutine durchläuft die Items-Sammlung des Steuerelements und testet die Selected-Eigenschaft jedes Elements. Die ausgewählten Elemente werden in einem Label-Steuerelement angezeigt.


Web Server ControlsWebserver-Steuerelement Weitere Erweiterungen