Gewusst wie: Hinzufügen von Elementen zu List-Webserversteuerelementen (Visual Studio)

Aktualisiert: November 2007

Die Informationen in diesem Thema beziehen sich auf die folgenden Webserversteuerelemente:

• ListBox

• DropDownList

• CheckBoxList

• RadioButtonList

• BulletedList

Sie können einem List-Webserversteuerelement auf die folgenden drei Arten Elemente hinzufügen:

• Fügen Sie zur Entwurfszeit statische Elemente hinzu.

• Fügen Sie Elemente zur Laufzeit programmgesteuert hinzu.

• Fügen Sie Elemente mithilfe der Datenbindung hinzu. Ausführliche Informationen finden Sie unter Gewusst wie: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle (Visual Studio).

Beim Hinzufügen eines Listenelements können Sie bis zu drei Eigenschaften für das Element angeben. In der folgenden Tabelle werden diese Eigenschaften beschrieben.

Eigenschaft	Beschreibung
Text	Gibt den in der Liste angezeigten Text an.
Value	Gibt einen Wert an, der einem Element zugeordnet ist, aber nicht angezeigt wird. Sie können beispielsweise den Namen eines chemischen Elements als Text-Eigenschaft und das Symbol des Elements als Value-Eigenschaft festlegen.
Selected	Gibt an, ob das Element ausgewählt ist. In einem CheckBoxList-Steuerelement oder einem für Mehrfachauswahlen konzipierten ListBox-Steuerelement kann mehr als ein Element ausgewählt werden. In einem DropDownList-Steuerelement, einem RadioButtonList-Steuerelement und dem für die Einzelauswahl konzipierten ListBox-Steuerelement kann jeweils nur ein Element ausgewählt werden. Wenn Sie diese Steuerelemente für mehr als ein ausgewähltes Element konfigurieren, wird durch den Browser bestimmt, welches Element als ausgewählt gerendert wird. In einem BulletedList-Steuerelement hat diese Einstellung keine Auswirkungen.

So fügen Sie zur Entwurfszeit statische Elemente hinzu

1. Wählen Sie in der Entwurfsansicht das Listensteuerelement aus, dem Sie Elemente hinzufügen möchten.

   Klicken Sie im Eigenschaftenfenster auf die Schaltfläche mit den Auslassungszeichen () im Feld Items.

   Das Dialogfeld ListItem-Auflistungs-Editor wird angezeigt.

2. Klicken Sie auf Hinzufügen, um ein neues Element hinzuzufügen.

3. Wählen Sie das neue Element aus, und geben Sie im Eigenschaftenraster Werte für die Eigenschaften Text, Value und Selected ein.

4. Wiederholen Sie Schritt 2 und 3 für jedes Element, das Sie hinzufügen möchten. Klicken Sie anschließend auf OK.

So fügen Sie Elemente programmgesteuert hinzu

1. Erstellen Sie ein neues Objekt vom Typ ListItem, und legen Sie die zugehörige Text-Eigenschaft und die Value-Eigenschaft fest. Normalerweise erstellen Sie das neue ListItem, indem Sie die Add-Methode aufrufen.

2. Rufen Sie die Add-Methode für die Items-Auflistung des Steuerelements auf, und übergeben Sie das neue Objekt.

   Das folgende Beispiel veranschaulicht, wie ListItem-Objekte einem ListBox-Steuerelement hinzugefügt werden. Dieses Verfahren ist bei allen Webserversteuerelementen identisch.

   Protected Sub Button1_Click(ByVal sender As System.Object, _
           ByVal e As System.EventArgs) Handles Button1.Click
       ListBox1.Items.Add(New ListItem("Carbon", "C"))
       ListBox1.Items.Add(New ListItem("Oxygen", "O"))
   End Sub
   

   Protected void Button1_Click (object sender, System.EventArgs e)
   {
       ListBox1.Items.Add(new ListItem("Carbon", "C"));
       ListBox1.Items.Add(new ListItem("Oxygen", "O"));
   }
   

Siehe auch

Aufgaben

Gewusst wie: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle (Visual Studio)