DropDownList.SelectedIndex-Eigenschaft

Artikel
08/20/2007

Ruft den Index des ausgewählten Elements im DropDownList-Steuerelement ab oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overrides Property SelectedIndex As Integer
'Usage
Dim instance As DropDownList
Dim value As Integer

value = instance.SelectedIndex

instance.SelectedIndex = value

public override int SelectedIndex { get; set; }

public:
virtual property int SelectedIndex {
    int get () override;
    void set (int value) override;
}

/** @property */
public int get_SelectedIndex ()

/** @property */
public void set_SelectedIndex (int value)

public override function get SelectedIndex () : int

public override function set SelectedIndex (value : int)

Eigenschaftenwert

Der Index des ausgewählten Elements im DropDownList-Steuerelement. Der Standardwert ist 0 (null). Dies bedeutet, dass das erste Element in der Liste ausgewählt ist.

Hinweise

Mit der SelectedIndex-Eigenschaft können Sie den Index des im DropDownList-Steuerelement ausgewählten Elements programmgesteuert festlegen oder ermitteln. Im DropDownList-Steuerelement ist immer ein Element ausgewählt. Es ist nicht möglich, die Auswahl aller Elemente in der Liste gleichzeitig aufzuheben.

Hinweis

Die Indizes der Elemente im DropDownList-Steuerelement sind nullbasiert.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der SelectedIndex-Eigenschaft das im DropDownList-Steuerelement ausgewählte Element bestimmt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
   <script runat="server" >
  
      Sub Selection_Change(sender As Object, e As EventArgs)
      
         ' Set the title format based on the value selected from the
         ' DropDownList control. The SelectedIndex property can be used
         ' to determine an enumeration value. Simply cast the value to 
         ' the appropriate enumeration type. Note that the value might
         ' need to be adjusted if the enumeration type is not zero-based.
         Calendar1.TitleFormat = CType(ModeList.SelectedIndex, TitleFormat)

      End Sub
  
   </script>
  
<body>

   <form runat="server">
  
      <h3> DropDownList SelectedIndex Example </h3>

      Choose the title format.

      <br><br> 
  
      <asp:Calendar id="Calendar1"
           ShowGridLines="True" 
           ShowTitle="True"
           runat="server"/>

      <br><br>

      <table cellpadding="5">

         <tr>

            <td>

               Format:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ModeList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server">

                  <asp:ListItem> Month </asp:ListItem>
                  <asp:ListItem Selected="True"> MonthYear </asp:ListItem>

               </asp:DropDownList>

            </td>

         </tr>
  
   </form>

</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
   <script runat="server" >
  
      void Selection_Change(Object sender, EventArgs e)
      {

         // Set the title format based on the value selected from the
         // DropDownList control. The SelectedIndex property can be used
         // to determine an enumeration value. Simply cast the value to 
         // the appropriate enumeration type. Note that the value might
         // need to be adjusted if the enumeration type is not zero-based. 
         Calendar1.TitleFormat = (TitleFormat)ModeList.SelectedIndex;

      }
  
   </script>
  
<body>

   <form runat="server">
  
      <h3> DropDownList SelectedIndex Example </h3>

      Choose the title format.

      <br><br> 
  
      <asp:Calendar id="Calendar1"
           ShowGridLines="True" 
           ShowTitle="True"
           runat="server"/>

      <br><br>

      <table cellpadding="5">

         <tr>

            <td>

               Format:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ModeList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server">

                  <asp:ListItem> Month </asp:ListItem>
                  <asp:ListItem Selected="True"> MonthYear </asp:ListItem>

               </asp:DropDownList>

            </td>

         </tr>
  
   </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

DropDownList-Klasse
DropDownList-Member
System.Web.UI.WebControls-Namespace
Items

Freigeben über