HtmlSelect.SelectedIndex Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur indeks ordinal item yang dipilih dalam HtmlSelect kontrol.
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 IntegerNilai Properti
Indeks ordinal item yang dipilih dalam HtmlSelect kontrol. Nilai -1 menunjukkan bahwa tidak ada item yang dipilih.
- Atribut
Pengecualian
Properti diatur ke nilai yang lebih besar dari jumlah item dalam HtmlSelect kontrol atau kurang dari -1.
Contoh
Contoh kode berikut menunjukkan cara menggunakan SelectedIndex properti untuk menentukan indeks item yang dipilih dalam HtmlSelect kontrol. Indeks kemudian digunakan untuk mengambil item yang dipilih dari Items koleksi.
<%@ 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>
Keterangan
Properti SelectedIndex umumnya digunakan untuk menentukan indeks item yang dipilih dalam kontrol pilihan HtmlSelect tunggal. Indeks ini kemudian dapat digunakan untuk mengambil item dari Items koleksi.
Multiple Jika properti diatur ke true, menunjukkan bahwa beberapa item dapat dipilih secara bersamaan, SelectedIndex properti berisi indeks item pertama yang dipilih. Untuk menentukan item yang dipilih dari HtmlSelect kontrol yang memungkinkan beberapa pilihan simultan, iterasi melalui Items koleksi dan uji ListItem.Selected properti setiap item.
Perhatian
Dimungkinkan untuk tidak memiliki item yang dipilih. Jika tidak ada item yang dipilih, SelectedIndex properti berisi nilai -1. Ini biasanya terjadi ketika halaman pertama kali dimuat dan item tidak dipilih secara default. Berikan kode untuk menguji nilai ini sebelum mereferensikan item dalam Items koleksi. Jika tidak, pengecualian akan dilemparkan jika indeks berada di luar rentang koleksi.
Secara default, HtmlSelect kontrol ditampilkan sebagai kotak daftar drop-down. Jika Anda mengizinkan beberapa pilihan (dengan mengatur Multiple properti ke true) atau menentukan tinggi yang lebih besar dari satu baris (dengan mengatur Size properti ke nilai yang lebih besar dari 1), kontrol ditampilkan sebagai kotak daftar. Jika kotak daftar drop-down ditampilkan, item selalu dipilih. Jika kotak daftar ditampilkan, Anda dapat menghapus pilihan secara terprogram dari semua item dengan mengatur SelectedIndex properti ke -1.
