HtmlSelect.SelectedIndex Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Ordinalindex des ausgewählten Elements in einem HtmlSelect Steuerelement ab oder legt diesen fest.
public:
virtual property int SelectedIndex { int get(); void set(int value); };[System.ComponentModel.Browsable(false)]
public virtual int SelectedIndex { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.SelectedIndex : int with get, setPublic Overridable Property SelectedIndex As IntegerEigenschaftswert
Der Ordnungsindex des ausgewählten Elements in einem HtmlSelect Steuerelement. Ein Wert, der -1 angibt, dass kein Element ausgewählt ist.
- Attribute
Ausnahmen
Die Eigenschaft wurde auf einen Wert festgelegt, der größer als die Anzahl der Elemente im HtmlSelect Steuerelement oder kleiner als ist -1.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die SelectedIndex Eigenschaft verwendet wird, um den Index des ausgewählten Elements im HtmlSelect Steuerelement zu bestimmen. Der Index wird dann verwendet, um das ausgewählte Element aus der Items Auflistung abzurufen.
<%@ 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 Example </title>
<script runat="server">
void Button_Click (Object sender, EventArgs e)
{
Label1.Text = "You selected the item with index number " +
Select1.SelectedIndex.ToString() +
" and contains the value " +
Select1.Value + ".";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br /><br />
<select id="Select1"
runat="server">
<option value="Text for Item 1" selected="selected"> Item 1 </option>
<option value="Text for Item 2"> Item 2 </option>
<option value="Text for Item 3"> Item 3 </option>
<option value="Text for Item 4"> Item 4 </option>
<option value="Text for Item 5"> Item 5 </option>
<option value="Text for Item 6"> Item 6 </option>
</select>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
<%@ 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 Example </title>
<script runat="server">
Sub Button_Click (sender As Object, e As EventArgs)
Label1.Text = "You selected the item with index number " & _
Select1.SelectedIndex.ToString() & _
" and contains the value " & _
Select1.Value & "."
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br /><br />
<select id="Select1"
runat="server">
<option value="Text for Item 1" selected="selected"> Item 1 </option>
<option value="Text for Item 2"> Item 2 </option>
<option value="Text for Item 3"> Item 3 </option>
<option value="Text for Item 4"> Item 4 </option>
<option value="Text for Item 5"> Item 5 </option>
<option value="Text for Item 6"> Item 6 </option>
</select>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
Hinweise
Die SelectedIndex Eigenschaft wird häufig verwendet, um den Index des ausgewählten Elements in einem Steuerelement mit einer Auswahl HtmlSelect zu bestimmen. Dieser Index kann dann verwendet werden, um das Element aus der Items Auflistung abzurufen.
Wenn die Multiple Eigenschaft auf " true, angibt, dass mehrere Elemente gleichzeitig ausgewählt werden können, enthält die SelectedIndex Eigenschaft den Index des ersten ausgewählten Elements. Um die ausgewählten Elemente aus einem HtmlSelect Steuerelement zu ermitteln, das mehrere gleichzeitige Auswahlen zulässt, durchlaufen Sie die Items Auflistung, und testen Sie die ListItem.Selected Eigenschaft jedes Elements.
Vorsicht
Es ist möglich, dass kein Element ausgewählt ist. Wenn kein Element ausgewählt ist, enthält die SelectedIndex Eigenschaft einen Wert von -1. Dies tritt häufig auf, wenn die Seite zuerst geladen wird und ein Element standardmäßig nicht ausgewählt ist. Stellen Sie Code bereit, um diesen Wert zu testen, bevor Sie auf das Element in der Items Auflistung verweisen. Andernfalls wird eine Ausnahme ausgelöst, wenn sich der Index außerhalb des Bereichs der Auflistung befindet.
Standardmäßig wird das HtmlSelect Steuerelement als Dropdown-Listenfeld angezeigt. Wenn Sie mehrere Auswahlmöglichkeiten zulassen (durch Festlegen der Multiple Eigenschaft auf true) oder eine Höhe größer als eine Zeile angeben (durch Festlegen der Size Eigenschaft auf einen Wert größer als 1), wird das Steuerelement als Listenfeld angezeigt. Wenn ein Dropdown-Listenfeld angezeigt wird, wird immer ein Element ausgewählt. Wenn ein Listenfeld angezeigt wird, können Sie die Auswahl programmgesteuert von allen Elementen löschen, indem Sie die SelectedIndex Eigenschaft auf -1festlegen.
