Deklarative Syntax des HtmlSelect-Serversteuerelements
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Generiert ein serverseitiges Steuerelement, das dem <select>-HTML-Element zugeordnet wird und die Erstellung eines Listensteuerelements ermöglicht.
<select
DataSourceID="string"
DataTextField="string"
EnableViewState="False|True"
Id="string"
Visible="False|True"
OnDataBinding="OnDataBinding event handler"
OnDisposed="OnDisposed event handler"
OnInit="OnInit event handler"
OnLoad="OnLoad event handler"
OnPreRender="OnPreRender event handler"
OnServerChange="OnServerChange event handler"
OnUnload="OnUnload event handler"
runat="server"
>
<option>value1</option>
<option>value2</option>
</select>
Hinweise
Verwenden Sie das HtmlSelect-Steuerelement, um das <select>-HTML-Element zu programmieren. Dieses Steuerelement wird standardmäßig als Dropdown-Listenfeld gerendert. Wenn Sie jedoch mehrere Auswahlmöglichkeiten zulassen (durch Angabe des Multiple-Attributs) oder für die Size-Eigenschaft einen Wert größer als 1 angeben, wird das Steuerelement als Listenfeld angezeigt.
Sie können das Steuerelement auch an eine Datenquelle binden. Legen Sie die DataSource-Eigenschaft fest, um die Datenquelle anzugeben, die an das Steuerelement zu binden ist. Nachdem Sie die Datenquelle an das Steuerelement gebunden haben, können Sie angeben, welches Feld an die Value-Eigenschaft und die Text-Eigenschaft gebunden werden soll, indem Sie die DataValueField-Eigenschaft bzw. die DataTextField-Eigenschaft festlegen.
Beispiel
Im folgenden Beispiel wird anhand von Einträgen in einem HtmlSelect-Steuerelement die Hintergrundfarbe für ein span-Steuerelement festgelegt. Das Beispiel zeigt außerdem, wie Sie mit der Items-Eigenschaft neue Optionen zu der Auswahlliste hinzufügen können. Diese Eigenschaft gehört zu dem ListItemCollection-Typ und kann deshalb auf die Add-Methode dieser Klasse zugreifen. Im Beispielcode geschieht dies im AddToList_Click -Ereignishandler.
<%@ 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>HtmlSelect Control</title>
<script runat="server">
Sub Apply_Click(Source As Object, e As EventArgs)
Span1.Style("background-color") = ColorSelect.Value
End Sub
Sub AddToList_Click(Source As Object, e As EventArgs)
ColorSelect.Items.Add(Text1.Value)
End Sub
</script>
</head>
<body>
<h3>HtmlSelect Sample</h3>
<form id="Form1" runat="server">
Select a color:<br />
<select id="ColorSelect" runat="server">
<option>SkyBlue</option>
<option>LightGreen</option>
<option>Gainsboro</option>
<option>LemonChiffon</option>
</select>
<input id="Button1" type="button" runat="server"
value="Apply" onserverclick="Apply_Click" />
<p />
Don't see your color in the list above? You can add it here:<br />
<input type="text" id="Text1" runat="server" />
<input id="Button2" type="button" runat="server"
value="Add to List" onserverclick="AddToList_Click" />
<p />
<span id="Span1" runat="server">
Click the button to apply a background color to this span.
</span>
</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>HtmlSelect Control</title>
<script runat="server">
void Apply_Click(object Source, EventArgs e)
{
Span1.Style["background-color"] = ColorSelect.Value;
}
void AddToList_Click(object Source, EventArgs e)
{
ColorSelect.Items.Add(Text1.Value);
}
</script>
</head>
<body>
<h3>HtmlSelect Sample</h3>
<form id="Form1" runat="server">
Select a color:<br />
<select id="ColorSelect" runat="server">
<option>SkyBlue</option>
<option>LightGreen</option>
<option>Gainsboro</option>
<option>LemonChiffon</option>
</select>
<input id="Button1" type="button" runat="server"
value="Apply" onserverclick="Apply_Click" />
<p />
Don't see your color in the list above? You can add it here:<br />
<input type="text" id="Text1" runat="server" />
<input id="Button2" type="button" runat="server"
value="Add to List" onserverclick="AddToList_Click" />
<p />
<span id="Span1" runat="server">
Click the button to apply a background color to this span.
</span>
</form>
</body>
</html>
Im folgenden Beispiel wird veranschaulicht, wie ein HtmlSelect-Steuerelement an ein ArrayList-Element gebunden wird, das im Page_Load-Ereignis deklariert ist. Außerdem zeigt ein SubmitBtn_Click-Ereignis den ausgewählten datengebundenen Wert an, wenn der Benutzer auf ein HtmlInputButton-Steuerelement auf der gerenderten Seite klickt.
Die Id-Eigenschaft für das Auswahlsteuerelement ist StateSelect, und die DataSource-Eigenschaft des Steuerelements wird auf die Werte festgelegt, die das ArrayList-Element erstellt, wenn die Seite geladen wird. Dann bindet die DataBind-Methode des Auswahlsteuerelements die Werte in der ArrayList an das Steuerelement selbst.
<%@ 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>HtmlSelect Control</title>
<script runat="server">
Sub Page_Load(Sender As Object, e As EventArgs)
If Not IsPostBack Then
Dim values As New ArrayList()
values.Add("IN")
values.Add("KS")
values.Add("MD")
values.Add("MI")
values.Add("OR")
values.Add("TN")
StateSelect.DataSource = values
StateSelect.DataBind()
End If
End Sub
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
Span1.InnerHtml = "You chose: " & StateSelect.Value
End Sub
</script>
</head>
<body>
<h3>Data Binding to an HtmlSelect Control</h3>
<form id="Form1" runat="server">
Select a state:<br />
<select id="StateSelect" runat="server" />
<input id="Submit1" type="submit" value="Display Selected State"
onserverclick="SubmitBtn_Click" runat="server" />
<p />
<span id="Span1" 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>HtmlSelect Control</title>
<script runat="server">
void Page_Load(Object Sender, EventArgs e)
{
if (!IsPostBack)
{
ArrayList values = new ArrayList();
values.Add ("IN");
values.Add ("KS");
values.Add ("MD");
values.Add ("MI");
values.Add ("OR");
values.Add ("TN");
StateSelect.DataSource = values;
StateSelect.DataBind();
}
}
void SubmitBtn_Click(Object sender, EventArgs e)
{
Span1.InnerHtml = "You chose: " + StateSelect.Value;
}
</script>
</head>
<body>
<h3>Data Binding to an HtmlSelect Control</h3>
<form id="Form1" runat="server">
Select a state:<br />
<select id="StateSelect" runat="server" />
<input id="Submit1" type="submit" value="Display Selected State"
onserverclick="SubmitBtn_Click" runat="server" />
<p />
<span id="Span1" runat="server" />
</form>
</body>
</html>
Siehe auch
Referenz
Deklarative Syntax des HtmlForm-Serversteuerelements