Übersicht über das ListBox-Webserversteuerelement

Artikel
10/22/2014

Aktualisiert: November 2007

Über das ListBox-Webserver-Steuerelement können Benutzer ein oder mehrere Elemente aus einer vordefinierten Liste auswählen.

Dieses Thema enthält folgende Abschnitte:

Szenarien
Features
Hintergrund
Codebeispiele
Klassenreferenz

Szenarien

Verwenden Sie das ListBox-Webserversteuerelement, um mehrere Elemente gleichzeitig anzuzeigen und um Benutzer ein oder mehrere Elemente aus einer vordefinierten Liste auszuwählen zu lassen. Das ListBox-Steuerelement unterscheidet sich von einem DropDownList-Steuerelement dadurch, dass gleichzeitig mehrere Elemente angezeigt und optional auch mehrere Elemente ausgewählt werden können.

Zurück nach oben

Features

Sie können das ListBox-Steuerelement für folgende Aktionen verwenden:

Sie können festlegen, dass ein Steuerelement eine bestimmte Anzahl von Elementen anzeigen soll.
Legen Sie die Größe des Steuerelements in Pixel fest.
Verwenden Sie Datenbindung, um die Liste der anzuzeigenden Elemente festzulegen.
Bestimmen Sie, welches Element oder welche Elemente ausgewählt werden sollen.
Geben Sie das ausgewählte Element oder die Elemente programmgesteuert an.

Zurück nach oben

Hintergrund

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 festlegen, dass ein Steuerelement eine bestimmte Anzahl von Elementen anzeigen soll. Wenn die Anzahl der Elemente im Steuerelement dieses Maximum übersteigt, wird eine vertikale Bildlaufleiste angezeigt.
Höhe und Breite. Sie können die Größe des Steuerelements in Pixel festlegen. Die festgelegte Zeilenanzahl wird in diesem Fall vom Steuerelement ignoriert, und es werden so viele Zeilen angezeigt, wie die Höhe des Steuerelements es zulässt. 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 mithilfe von Stilobjekten angepasst werden. Ausführliche Informationen finden Sie unter ASP.NET-Webserversteuerelemente und CSS-Formatvorlagen.

Listenelemente

Das ListBox-Steuerelement ist ein Container für ein oder mehrere Listenelemente. Jedes Listenelement ist ein Objekt des Typs ListItem mit seinen eigenen Eigenschaften. Diese Eigenschaften werden im Folgenden beschrieben.

Eigenschaft	Beschreibung
Text	Gibt den Text an, der in der Liste angezeigt wird.
Value	Enthält den Wert, der einem Element zugeordnet wird. Diese Eigenschaft bietet die Möglichkeit, einem bestimmten Element einen Wert zuzuordnen, ohne ihn anzuzeigen. Sie können beispielsweise die Text-Eigenschaft auf den Namen einer Farbe und die Value-Eigenschaft auf deren hexadezimale Darstellung festlegen.
Selected	Gibt an, ob das Element momentan ausgewählt ist.

Um Elemente programmgesteuert zu bearbeiten, verwenden Sie 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.

Das aktuell ausgewählte Element wird durch die SelectedItem-Eigenschaft des ListBox-Steuerelements identifiziert. Wenn das Steuerelement auf den Einfachauswahlmodus festgelegt ist, gibt diese Eigenschaft das ausgewählte Element zurück. Wenn das Steuerelement auf den Mehrfachauswahlmodus festgelegt ist, können Sie auf die gewählten Elemente zugreifen, indem Sie die gesamte Items-Auflistung durch eine Schleife laufen lassen, um die Selected-Eigenschaft jedes Elements zu überprüfen.

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

Sie können ein ListBox-Webserversteuerelement verwenden, um die Optionen anzuzeigen, die der Seite durch ein Datenquellensteuerelement verfügbar gemacht werden. Jedes Element im ListBox-Steuerelement entspricht einem Element in der Datenquelle, in der Regel einem einzelnen Eintrag.

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 allen Serversteuerelementen können beliebige Steuerelementeigenschaften, wie Farbe oder Größe, an Daten gebunden werden. Weitere Informationen finden Sie unter Gewusst wie: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle (Visual Studio).

ListBox-Ereignisse

Bei Auswahl eines Elements durch den Benutzer löst das ListBox-Steuerelement das 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 festlegen.

Hinweis:
Für automatische Postbacks muss der Browser ECMAScript (Jscript oder JavaScript) unterstützen, und im Browser des Benutzers muss das Ausführen von Skripts zugelassen sein.