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 элемент управления отображается в виде раскрывающегося списка. Если вы разрешаете выбор нескольких элементов (путем задания свойству Multipletrueзначения ) или задаете высоту больше одной строки (задав Size для свойства значение больше 1), элемент управления отображается в виде списка. Если отображается раскрывающийся список, элемент всегда выбирается. Если отображается список, можно программно очистить выделенный фрагмент из всех элементов, задав свойству SelectedIndex значение -1.

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

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