DropDownList-Webserversteuerelement
Ermöglicht es dem Benutzer, ein einziges Element aus einer Dropdownliste auszuwählen. Die Dropdownliste kann beliebig viele Elemente enthalten.
<asp:DropDownListid="DropDownList1" runat="server" DataSource="<% databindingexpression %>" DataTextField="DataSourceField" DataValueField="DataSourceField" AutoPostBack="True|False" OnSelectedIndexChanged="OnSelectedIndexChangedMethod"> <asp:ListItemvalue="value" selected="True|False"> Text </asp:ListItem></asp:DropDownList>
Hinweise
Mit dem DropDownList-Steuerelement können Sie ein Dropdownlisten-Steuerelement für die Auswahl eines einzigen Elements erstellen. Sie können das Erscheinungsbild des DropDownList-Steuerelements festlegen, indem Sie die Eigenschaften BorderColor, BorderStyle und BorderWidth setzen.
Um die im DropDownList-Steuerelement darzustellenden Elemente anzugeben, platzieren Sie für jeden Eintrag ein ListItem-Objekt zwischen das öffnende und das schließende Tag des DropDownList-Steuerelements.
Das DropDownList-Steuerelement unterstützt auch die Datenbindung. Um das Steuerelement an eine Datenquelle zu binden, erstellen Sie zuerst eine Datenquelle, z. B. System.Collections.ArrayList, die die im Steuerelement darzustellenden Elemente enthält. Danach binden Sie die Datenquelle mit Hilfe der Control.DataBind-Methode an das DropDownList-Steuerelement. Geben Sie mit Hilfe der Eigenschaften DataTextField und DataValueField an, welches Feld in der Datenquelle jeweils an die Eigenschaften Text und Value der einzelnen Listenelemente in dem Steuerelement gebunden werden soll. Das DropDownList-Steuerelement zeigt nun die Informationen aus der Datenquelle an.
Mit der SelectedIndex-Eigenschaft ermitteln Sie programmgesteuert den Index des Elements, das der Benutzer im DropDownList-Steuerelement ausgewählt hat. Anhand des Indexes kann dann das ausgewählte Element aus der Items-Auflistung des Steuerelements abgerufen werden.
Weitere Informationen zu den Eigenschaften und Ereignissen des DropDownList-Webserversteuerelements finden Sie unter DropDownList-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung des DropDownList-Steuerelements.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub Button_Click(sender As Object, e As EventArgs)
Label1.Text = "You selected " & _
DropDownList1.SelectedItem.Text & "."
End Sub 'Button_Click
</script>
</head>
<body>
<form runat="server">
<h3>DropDownList Example</h3>
Select an item from the list and click the submit button.
<p>
<asp:DropDownList id="DropDownList1"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
</asp:DropDownList>
<br><br>
<asp:Button id="Button1"
Text="Submit"
OnClick="Button_Click"
runat="server"/>
<br><br>
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
[C#]
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void Button_Click(Object sender, EventArgs e)
{
Label1.Text = "You selected: " +
dropdownlist1.SelectedItem.Text + ".";
}
</script>
</head>
<body>
<form runat="server">
<h3>DropDownList Example</h3>
Select an item from the list and click the submit button.
<p>
<asp:DropDownList id="dropdownlist1" runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
</asp:DropDownList>
<br><br>
<asp:Button id="Button1"
Text="Submit"
OnClick="Button_Click"
runat="server"/>
<br><br>
<asp:Label id="Label1" runat="server"/>
</form>
</body>
</html>