HtmlSelect.SelectedIndex Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de rangtelindex van het geselecteerde item in een HtmlSelect besturingselement op of stelt u deze in.
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 IntegerWaarde van eigenschap
De rangtelindex van het geselecteerde item in een HtmlSelect besturingselement. Een waarde waarmee -1 wordt aangegeven dat er geen item is geselecteerd.
- Kenmerken
Uitzonderingen
De eigenschap is ingesteld op een waarde die groter is dan het aantal items in het HtmlSelect besturingselement of kleiner dan -1.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de SelectedIndex eigenschap gebruikt om de index van het geselecteerde item in het HtmlSelect besturingselement te bepalen. De index wordt vervolgens gebruikt om het geselecteerde item op te halen uit de Items verzameling.
<%@ 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>
Opmerkingen
De SelectedIndex eigenschap wordt vaak gebruikt om de index van het geselecteerde item in een besturingselement voor één selectie HtmlSelect te bepalen. Deze index kan vervolgens worden gebruikt om het item op te halen uit de Items verzameling.
Als de Multiple eigenschap is ingesteld op true, waarmee wordt aangegeven dat meerdere items gelijktijdig kunnen worden geselecteerd, bevat de SelectedIndex eigenschap de index van het eerste geselecteerde item. Als u de geselecteerde items van een HtmlSelect besturingselement wilt bepalen waarmee meerdere gelijktijdige selecties zijn toegestaan, doorloopt u de Items verzameling en test u de ListItem.Selected eigenschap van elk item.
Caution
Het is mogelijk om geen item te selecteren. Als er geen item is geselecteerd, bevat de SelectedIndex eigenschap een waarde van -1. Dit gebeurt meestal wanneer de pagina voor het eerst wordt geladen en een item niet standaard is geselecteerd. Geef code op om deze waarde te testen voordat u naar het item in de Items verzameling verwijst. Anders wordt er een uitzondering gegenereerd als de index buiten het bereik van de verzameling valt.
Standaard wordt het HtmlSelect besturingselement weergegeven als een vervolgkeuzelijst. Als u meerdere selecties toestaat (door de Multiple eigenschap in te truestellen op) of een hoogte van meer dan één rij opgeeft (door de Size eigenschap in te stellen op een waarde groter dan 1), wordt het besturingselement weergegeven als een keuzelijst. Als er een vervolgkeuzelijst wordt weergegeven, wordt er altijd een item geselecteerd. Als er een keuzelijst wordt weergegeven, kunt u de selectie programmatisch wissen van alle items door de SelectedIndex eigenschap in te stellen op -1.