Einführung in das ListBox-Webserversteuerelement

Über das ListBox-Webserversteuerelement können Benutzer eines oder mehrere Elemente aus einer vordefinierten Liste auswählen. Dieses Steuerelement unterscheidet sich in zweifacher Hinsicht vom DropDownList-Steuerelement – es können mehrere Elemente gleichzeitig angezeigt werden, und der Benutzer hat die Möglichkeit, mehrere Elemente auszuwählen.

Darstellung des ListBox-Steuerelements

Das ListBox-Steuerelement wird normalerweise verwendet, wenn mehrere Elemente gleichzeitig angezeigt werden sollen. Sie können das Erscheinungsbild der Liste wie folgt festlegen:

• Anzahl der angezeigten Zeilen   Sie können das Steuerelement so programmieren, dass eine bestimmte Anzahl von Elementen angezeigt wird. Enthält das Steuerelement mehr Elemente als durch diesen Wert definiert, wird eine vertikale Bildlaufleiste angezeigt.
• Höhe und Breite   Sie können die Größe des Steuerelements in Pixeln festlegen. Die festgelegte Zeilenanzahl wird in diesem Fall vom Steuerelement ignoriert, und es werden so viele Zeilen angezeigt, wie in vertikaler Ausdehnung vom Steuerelement aufgenommen werden können. Einige Browser unterstützen die Einstellung von Höhe und Breite in Pixeln nicht und verwenden stattdessen die Zeilenanzahl als Einstellung.

Wie bei anderen Webserversteuerelementen kann die Darstellung des Steuerelements mit Hilfe von Stilobjekten angepasst werden. Ausführliche Informationen finden Sie unter Anpassen des Erscheinungsbilds von ASP.NET-Serversteuerelementen mit Formatvorlagen.

Elemente

Das ListBox-Steuerelement ist im eigentlichen Sinn ein Container für Listenelemente. Jedes Listenelement stellt ein separates Objekt mit individuellen Eigenschaften dar:

Eigenschaft	Beschreibung
Text	Der in der Liste angezeigte Text.
Value	Der mit einem Element verknüpfte Wert. Diese Eigenschaft bietet die Möglichkeit, einem bestimmten Element einen Wert zuzuordnen, ohne ihn anzuzeigen. Beispielsweise können Sie den Namen eines Mitarbeiters als Text-Eigenschaft und seinen E-Mail-Alias als Value-Eigenschaft festlegen.
Selected	Boolescher Wert, der angibt, ob das Element ausgewählt ist. Wenn das ListBox-Steuerelement für die Mehrfachauswahl konfiguriert ist, können mehrere Elemente ausgewählt werden.

Um Elemente programmgesteuert zu bearbeiten, verwenden Sie normalerweise die Items-Auflistung des ListBox-Steuerelements. Items ist eine Standardauflistung. Sie können der Auflistung Elementobjekte hinzufügen, Elemente daraus löschen, die Auflistung selbst löschen usw. Um festzustellen, welche Elemente ausgewählt sind, können Sie die Auflistung durchlaufen und einzelne Elemente überprüfen.

Um die Bedienungsfreundlichkeit zu erhöhen, unterstützt das ListBox-Steuerelement auch die Eigenschaft SelectedItem. Wenn das Steuerelement für die Einzelauswahl konfiguriert ist, gibt diese Eigenschaft dieses eine ausgewählte Element zurück. Daher muss nicht die gesamte Items-Auflistung durchlaufen werden, um zur aktuellen Auswahl zu gelangen.

Vergleich zwischen Einzel- und Mehrfachauswahl

Normalerweise wählt der Benutzer ein einzelnes Element in einer Liste aus, indem er darauf klickt. Wenn Sie das ListBox-Steuerelement für die Mehrfachauswahl konfigurieren, kann der Benutzer mehrere Elemente auswählen, indem er die STRG- oder UMSCHALTTASTE gedrückt hält und nacheinander auf die Elemente klickt.

Binden von Daten an das Steuerelement

In einem ListBox-Webserversteuerelement können Optionen aufgelistet werden, die aus einer Datenquelle ausgelesen werden. Jedes Element im ListBox-Steuerelement entspricht einem Element in der Datenquelle, in der Regel einer Zeile.

Das Steuerelement zeigt ein Feld aus der Datenquelle an. Optional können Sie das Steuerelement an ein zweites Feld binden, durch das der (nicht angezeigte) Wert eines Elements festgelegt wird.

Wie bei anderen Webserversteuerelementen können Sie beliebige Steuerelementeigenschaften, wie Farbe oder Größe des Steuerelements, an Daten binden. Ausführliche Informationen finden Sie unter Datenbindung in Web Forms.

ListBox-Ereignisse

Sobald der Benutzer ein Element auswählt, löst das ListBox-Steuerelement ein SelectedIndexChanged-Ereignis aus. 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. Wenn das ListBox-Steuerelement für die Mehrfachauswahl konfiguriert und AutoPostBack auf true gesetzt wurde, wird das Formular mit jeder Auswahl an den Server zurückgeschickt. Die aktuelle Auswahl wird jedoch bei jeder Schleife beibehalten.

Hinweis   Damit das ListBox-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.

Siehe auch

Hinzufügen von ListBox-Webserversteuerelementen zu einer Web Forms-Seite | Hinzufügen von Elementen zu einem List-Webserversteuerelement | Füllen eines List-Webserversteuerelements aus einer Datenbank | Bestimmen der Auswahl in einem List-Webserversteuerelement | Festlegen der Auswahl in einem List-Webserversteuerelement | Reagieren auf Änderungen in einem List-Webserversteuerelement