HtmlSelect.SelectedIndex-Eigenschaft
Ruft den Ordinalindex des ausgewählten Elements in einem HtmlSelect-Steuerelement ab oder legt diesen fest.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Overridable Property SelectedIndex As Integer
'Usage
Dim instance As HtmlSelect
Dim value As Integer
value = instance.SelectedIndex
instance.SelectedIndex = value
public virtual int SelectedIndex { get; set; }
public:
virtual property int SelectedIndex {
int get ();
void set (int value);
}
/** @property */
public int get_SelectedIndex ()
/** @property */
public void set_SelectedIndex (int value)
public function get SelectedIndex () : int
public function set SelectedIndex (value : int)
Eigenschaftenwert
Der Ordinalindex des ausgewählten Elements in einem HtmlSelect-Steuerelement. Ein Wert von -1 gibt an, dass kein Element ausgewählt ist.
Hinweise
Die SelectedIndex-Eigenschaft wird häufig verwendet, um den Index des ausgewählten Elements in einem HtmlSelect-Steuerelement mit einfacher Auswahl zu bestimmen. Mit diesem Index können Sie dann das Element aus der Items-Auflistung abrufen.
Wenn die Multiple-Eigenschaft auf true festgelegt ist, also mehrere Elemente gleichzeitig ausgewählt werden können, enthält die SelectedIndex-Eigenschaft den Index des ersten ausgewählten Elements. Zum Bestimmen der ausgewählten Elemente in einem HtmlSelect-Steuerelement, das die Auswahl mehrerer Elemente gleichzeitig zulässt, durchlaufen Sie die Items-Auflistung, und testen Sie die ListItem.Selected-Eigenschaft der einzelnen Elemente.
Warnung
Es ist möglich, dass kein Element ausgewählt wird. Wenn kein Element ausgewählt ist, enthält die SelectedIndex-Eigenschaft einen Wert von -1. Dies tritt häufig ein, wenn die Seite zuerst geladen wird und kein Element standardmäßig ausgewählt ist. Stellen Sie Code zum Testen dieses Werts bereit, bevor Sie auf das Element in der Items-Auflistung verweisen. Andernfalls wird eine Ausnahme ausgelöst, wenn sich der Index außerhalb des gültigen Bereichs der Auflistung befindet.
Das HtmlSelect-Steuerelement wird standardmäßig als Dropdown-Listenfeld angezeigt. Wenn Sie Mehrfachauswahl zulassen (durch Festlegen der Multiple-Eigenschaft auf true) oder eine Höhe von mehr als einer 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, ist immer ein Element ausgewählt. Wenn ein Listenfeld angezeigt wird, können Sie die Auswahl aller Elemente programmgesteuert aufheben, indem Sie die SelectedIndex-Eigenschaft auf -1 festlegen.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit der SelectedIndex-Eigenschaft den Index des im HtmlSelect-Steuerelement ausgewählten Elements bestimmen. Der Index wird dann zum Abrufen des ausgewählten Elements aus der Items-Auflistung verwendet.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<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 runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br><br>
<select id="Select1"
Multiple="False"
runat="server">
<option value="Text for Item 1" Selected="True"> 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="C#" AutoEventWireup="True" %>
<html>
<head>
<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 runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br><br>
<select id="Select1"
Multiple="False"
runat="server">
<option value="Text for Item 1" Selected="True"> 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="JScript" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
function Button_Click (sender : Object, e: EventArgs) : void
{
Label1.Text = "You selected the item with index number " +
Select1.SelectedIndex.ToString() +
" and contains the value " +
Select1.Value + ".";
}
</script>
</head>
<body>
<form runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br><br>
<select id="Select1"
Multiple="False"
runat="server">
<option value="Text for Item 1" Selected="True"> 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>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
HtmlSelect-Klasse
HtmlSelect-Member
System.Web.UI.HtmlControls-Namespace
HtmlSelect.Items-Eigenschaft
ListItem.Selected
HtmlSelect.Multiple-Eigenschaft
Size