HtmlSelect.SelectedIndex Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger ordningstalet för det markerade objektet i en HtmlSelect kontroll.
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
Egenskapsvärde
Ordningstalet för det markerade objektet i en HtmlSelect kontroll.
-1 Värdet anger att inget objekt har valts.
- Attribut
Undantag
Egenskapen har angetts till ett värde som är större än antalet objekt i HtmlSelect kontrollen eller mindre än -1.
Exempel
Följande kodexempel visar hur du använder SelectedIndex egenskapen för att fastställa indexet för det markerade objektet i HtmlSelect kontrollen. Indexet används sedan för att hämta det markerade objektet från Items samlingen.
<%@ 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>
Kommentarer
Egenskapen SelectedIndex används ofta för att fastställa indexet för det markerade objektet i en enda markeringskontroll HtmlSelect . Det här indexet kan sedan användas för att hämta objektet från Items samlingen.
Om egenskapen Multiple är inställd på true, som anger att flera objekt kan väljas samtidigt, SelectedIndex innehåller egenskapen indexet för det första markerade objektet. För att fastställa de markerade objekten från en HtmlSelect kontroll som tillåter flera samtidiga val itererar du genom Items samlingen och testar egenskapen för ListItem.Selected varje objekt.
Caution
Det går att inte välja något objekt. Om inget objekt har valts innehåller egenskapen SelectedIndex värdet -1. Detta inträffar vanligtvis när sidan först läses in och ett objekt inte är markerat som standard. Ange kod för att testa det här värdet innan du refererar till objektet i Items samlingen. Annars utlöses ett undantag om indexet ligger inom samlingens intervall.
Som standard HtmlSelect visas kontrollen som en listruta. Om du tillåter flera val (genom att ange Multiple egenskapen till true) eller ange en höjd som är större än en rad (genom att ange Size egenskapen till ett värde som är större än 1), visas kontrollen som en listruta. Om en listruta visas markeras alltid ett objekt. Om en listruta visas kan du programmatiskt rensa markeringen från alla objekt genom att ange SelectedIndex egenskapen till -1.