Deklarative Syntax des ListBox-Webserversteuerelements
Aktualisiert: November 2007
Erstellt ein Listenfeld, in dem die Auswahl eines oder mehrerer Elemente möglich ist.
<asp:ListBox
AccessKey="string"
AppendDataBoundItems="True|False"
AutoPostBack="True|False"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DataTextField="string"
DataTextFormatString="string"
DataValueField="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnTextChanged="TextChanged event handler"
OnUnload="Unload event handler"
Rows="integer"
runat="server"
SelectedIndex="integer"
SelectedValue="string"
SelectionMode="Single|Multiple"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
>
<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="string"
Value="string"
/>
</asp:ListBox>
Hinweise
Mit dem ListBox-Steuerelement können Sie ein Listensteuerelement erstellen, in dem die Auswahl eines oder mehrerer Elemente möglich ist. Mit der Rows-Eigenschaft geben Sie die Höhe des Steuerelements an. Um die Auswahl mehrerer Elemente zu aktivieren, legen Sie die SelectionMode-Eigenschaft auf Multiple fest.
Um die im ListBox-Steuerelement darzustellenden Elemente anzugeben, platzieren Sie für jeden Eintrag ein ListItem-Element zwischen dem Start- und dem Endtag des ListBox-Steuerelements.
Das ListBox-Steuerelement unterstützt auch Datenbindung. Erstellen Sie zum Binden des Steuerelements an eine Datenquelle zunächst eine Datenquelle, die die im Steuerelement anzuzeigenden Elemente enthält, z. B. eines der DataSourceControl-Objekte. Binden Sie die Datenquelle anschließend mithilfe der DataBind-Methode an das ListBox-Steuerelement. Mithilfe der DataTextField-Eigenschaft und der DataValueField-Eigenschaft können Sie angeben, welches Feld der Datenquelle jeweils an die Text-Eigenschaft und die Value-Eigenschaft eines jeden Elements im Steuerelement gebunden werden soll. Das ListBox-Steuerelement zeigt nun die Informationen aus der Datenquelle an.
Wenn die SelectionMode-Eigenschaft auf Multiple festgelegt ist, können Sie die ausgewählten Elemente im ListBox-Steuerelement bestimmen, indem Sie die Items-Auflistung durchlaufen und die Selected-Eigenschaft jedes Elements in der Auflistung überprüfen. Wenn die SelectionMode-Eigenschaft auf Single festgelegt ist, können Sie mithilfe der SelectedIndex-Eigenschaft den Index des ausgewählten Elements bestimmen. Der Index kann anschließend zum Abrufen des Elements aus der Items-Auflistung verwendet werden.
Ausführliche Informationen zu den Eigenschaften und Ereignissen von ListBox-Webserversteuerelementen finden Sie in der Dokumentation zur ListBox-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht, wie mithilfe des ListBox-Steuerelements dem Benutzer eine Liste von vordefinierten Optionen angezeigt werden kann. Das vom Benutzer ausgewählte Element wird in einem Label-Steuerelement angezeigt.
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ListBox Example</title>
<script language="VB" runat="server">
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
If ListBox1.SelectedIndex > - 1 Then
Label1.Text = "You chose: " & ListBox1.SelectedItem.Text
End If
End Sub 'SubmitBtn_Click
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
SelectionMode="Single"
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:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:ListBox>
<asp:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<asp:Label id="Label1"
Font-Names="Verdana"
Font-Size="10pt"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ListBox Example</title>
<script language="C#" runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
if (ListBox1.SelectedIndex > -1)
Label1.Text="You chose: " + ListBox1.SelectedItem.Text;
}
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
SelectionMode="Single"
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:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:ListBox>
<asp:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<asp:Label id="Label1"
Font-Names="Verdana"
Font-Size="10pt"
runat="server"/>
</form>
</body>
</html>