Бөлісу құралы:

HtmlSelect.SelectedIndex Свойство

Определение

Пространство имен:
System.Web.UI.HtmlControls
Сборка:
System.Web.dll

Возвращает или задает порядковый индекс выбранного элемента в элементе HtmlSelect управления.

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

Значение свойства

Int32

Порядковый индекс выбранного элемента в элементе HtmlSelect управления. Значение -1 указывает, что элемент не выбран.

Атрибуты
BrowsableAttribute

Исключения

ArgumentOutOfRangeException

Для свойства задано значение, превышающее количество элементов в элементе HtmlSelect управления или меньше -1.

Примеры

В следующем примере кода показано, как использовать SelectedIndex свойство для определения индекса выбранного элемента в элементе HtmlSelect управления. Затем индекс используется для извлечения выбранного Items элемента из коллекции.


<%@ 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>

Комментарии

Свойство SelectedIndex обычно используется для определения индекса выбранного элемента в элементе управления с одним выделением HtmlSelect . Затем этот индекс можно использовать для получения элемента из Items коллекции.

Multiple Если для свойства задано trueзначение , указывающее, что одновременно можно выбрать несколько элементов, SelectedIndex свойство содержит индекс первого выбранного элемента. Чтобы определить выбранные элементы из HtmlSelect элемента управления, разрешающие несколько одновременных выборов, выполните итерацию по Items коллекции и проверьте ListItem.Selected свойство каждого элемента.

Предостережение

Невозможно выбрать элемент. Если элемент не выбран, SelectedIndex свойство содержит значение -1. Обычно это происходит при первой загрузке страницы, а элемент не выбран по умолчанию. Предоставьте код для проверки этого значения перед ссылкой на элемент в Items коллекции. В противном случае создается исключение, если индекс выходит из диапазона коллекции.

По умолчанию элемент HtmlSelect управления отображается в раскрывающемся списке. Если можно разрешить несколько выборов (задав Multiple для свойства значение ) или укажите высоту больше одной строки (задав Size для свойства trueзначение больше1), элемент управления отображается в виде поля списка. Если отображается раскрывающееся окно, всегда выбирается элемент. Если отображается поле списка, можно программно очистить выбор из всех элементов, задав SelectedIndex для свойства значение -1.

Применяется к

См. также раздел