HtmlSelect.SelectedIndex Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállítja a kijelölt elem sorszámindexét egy HtmlSelect vezérlőelemben.
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, setPublic Overridable Property SelectedIndex As IntegerTulajdonság értéke
A vezérlőelem kijelölt HtmlSelect elemének sorszámindexe. Egy érték -1 azt jelzi, hogy nincs elem kijelölve.
- Attribútumok
Kivételek
A tulajdonság értéke nagyobb, mint a vezérlőelem elemeinek száma, vagy kisebb, HtmlSelect mint -1.
Példák
Az alábbi példakód bemutatja, hogyan használható a tulajdonság a SelectedIndex vezérlőelemben kijelölt elem HtmlSelect indexének meghatározására. Ezután az index segítségével lekérheti a kijelölt elemet a Items gyűjteményből.
<%@ 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>
Megjegyzések
A SelectedIndex tulajdonságot gyakran használják a kijelölt elem indexének meghatározására egy kijelölési HtmlSelect vezérlőelemben. Ezzel az indexel lekérheti az elemet a Items gyűjteményből.
Ha a Multiple tulajdonság értéke true, amely azt jelzi, hogy egyszerre több elem is kijelölhető, a SelectedIndex tulajdonság tartalmazza az első kijelölt elem indexét. Ha több egyidejű kijelölést lehetővé tevő vezérlőelemből HtmlSelect szeretné meghatározni a kijelölt elemeket, iterálja végig a Items gyűjteményt, és tesztelje az ListItem.Selected egyes elemek tulajdonságát.
Figyelmeztetés
Lehetőség van arra, hogy ne legyen kijelölve elem. Ha nincs elem kijelölve, a SelectedIndex tulajdonság a következő értéket -1tartalmazza: . Ez általában akkor fordul elő, ha az oldal először betöltődik, és egy elem nincs alapértelmezés szerint kiválasztva. Adjon meg kódot az érték teszteléséhez, mielőtt hivatkozik a Items gyűjteményben lévő elemre. Ellenkező esetben a rendszer kivételt ad ki, ha az index kívül esik a gyűjtemény tartományán.
Alapértelmezés szerint a HtmlSelect vezérlő legördülő listaként jelenik meg. Ha több kijelölést engedélyez (a Multiple tulajdonság truebeállításával ) vagy egynél nagyobb magasságot ad meg (ha a Size tulajdonságot egynél 1nagyobb értékre állítja), a vezérlőelem listamezőként jelenik meg. Ha megjelenik egy legördülő lista, a program mindig kijelöl egy elemet. Ha megjelenik egy listamező, a tulajdonság SelectedIndexbeállításával programozott módon törölheti a kijelölést az -1 összes elemből.
