Aracılığıyla paylaş

HtmlSelect.SelectedIndex Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.HtmlControls
Bütünleştirilmiş Kod:
System.Web.dll

Denetimdeki seçili öğenin HtmlSelect sıra dizinini alır veya ayarlar.

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

Özellik Değeri

Int32

Denetimdeki seçili öğenin HtmlSelect sıralı dizini. değeri -1 hiçbir öğenin seçilmediğini gösterir.

Öznitelikler
BrowsableAttribute

Özel durumlar

ArgumentOutOfRangeException

özelliği, denetimdeki öğe sayısından büyük veya değerinden küçük -1bir değere HtmlSelect ayarlanmıştır.

Örnekler

Aşağıdaki kod örneği, denetiminde SelectedIndex seçili öğenin HtmlSelect dizinini belirlemek için özelliğinin nasıl kullanılacağını gösterir. Dizin daha sonra koleksiyondan Items seçilen öğeyi almak için kullanılır.


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

Açıklamalar

SelectedIndex özelliği genellikle tek seçimli HtmlSelect denetimde seçilen öğenin dizinini belirlemek için kullanılır. Bu dizin daha sonra öğeyi koleksiyondan Items almak için kullanılabilir.

Özelliği, Multiple birden çok öğenin eşzamanlı olarak seçilebileceğini belirten olarak ayarlanırsa true, SelectedIndex özellik seçilen ilk öğenin dizinini içerir. Birden çok eşzamanlı seçime izin veren bir HtmlSelect denetimden seçilen öğeleri belirlemek için koleksiyonda yineleme yapın Items ve her öğenin özelliğini test ListItem.Selected edin.

Dikkat

Seçili öğe olmaması mümkündür. Hiçbir öğe seçilmezse özelliği SelectedIndex değerini -1içerir. Bu durum genellikle sayfa ilk kez yüklendiğinde ve varsayılan olarak bir öğe seçilmediğinde ortaya çıkar. Koleksiyondaki Items öğeye başvurmadan önce bu değeri test etmek için kod sağlayın. Aksi takdirde, dizin koleksiyonun aralığının dışındaysa bir özel durum oluşturulur.

Varsayılan olarak, HtmlSelect denetim açılan liste kutusu olarak görüntülenir. Birden çok seçime izin verirseniz (özelliği trueolarak ayarlayarakMultiple) veya bir satırdan büyük bir yükseklik belirtirseniz (özelliği değerinden Size 1büyük bir değere ayarlayarak), denetim liste kutusu olarak görüntülenir. Açılan liste kutusu görüntülenirse, her zaman bir öğe seçilir. Liste kutusu görüntülenirse, özelliğini -1olarak ayarlayarak SelectedIndex seçimi tüm öğelerden program aracılığıyla temizleyebilirsiniz.

Şunlara uygulanır

Ayrıca bkz.