HtmlSelect.SelectedIndex Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

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, set
Public Overridable Property SelectedIndex As Integer

Eigenschaftswert

Int32

Der Ordinalindex des ausgewählten Elements in einem HtmlSelect-Steuerelement. Ein Wert von -1 gibt an, dass kein Element ausgewählt ist.

Attribute
BrowsableAttribute

Ausnahmen

ArgumentOutOfRangeException

Die Eigenschaft wurde auf einen Wert festgelegt, der über der Anzahl der Elemente im HtmlSelect-Steuerelement liegt oder kleiner als -1 ist.

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 Single-Selection-Steuerelement HtmlSelect zu bestimmen. Dieser Index kann dann verwendet werden, um das Element aus der Items Auflistung abzurufen.

Wenn die Multiple -Eigenschaft auf truefestgelegt ist, was 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 bestimmen, das mehrere gleichzeitige Auswahlen ermöglicht, durchlaufen Sie die Items Auflistung, und testen Sie die ListItem.Selected -Eigenschaft jedes Elements.

Achtung

Es ist möglich, dass kein Element ausgewählt ist. Wenn kein Element ausgewählt ist, enthält die SelectedIndex Eigenschaft den Wert .-1 Dies tritt häufig auf, wenn die Seite zum ersten Mal geladen wird und ein Element nicht standardmäßig ausgewählt ist. Stellen Sie Code bereit, um diesen Wert zu testen, bevor auf das Element in der Items Auflistung verwiesen wird. 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 Auswahlen zulassen (indem Sie die Multiple -Eigenschaft auf truefestlegen) oder eine Höhe größer als eine Zeile angeben (indem Sie die Size Eigenschaft auf einen Wert größer als 1festlegen), 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 für alle Elemente programmgesteuert löschen, indem Sie die SelectedIndex -Eigenschaft auf -1festlegen.

Gilt für:

Weitere Informationen