HtmlSelect.SelectedIndex プロパティ
HtmlSelect コントロールで選択された項目の序数インデックスを取得または設定します。
名前空間: System.Web.UI.HtmlControls
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Public Overridable Property SelectedIndex As Integer
'使用
Dim instance As HtmlSelect
Dim value As Integer
value = instance.SelectedIndex
instance.SelectedIndex = value
public virtual int SelectedIndex { get; set; }
public:
virtual property int SelectedIndex {
int get ();
void set (int value);
}
/** @property */
public int get_SelectedIndex ()
/** @property */
public void set_SelectedIndex (int value)
public function get SelectedIndex () : int
public function set SelectedIndex (value : int)
適用できません。
プロパティ値
HtmlSelect コントロールで選択された項目の序数インデックス。値が -1 である場合は項目が選択されていないことを示します。
例外
| 例外の種類 | 条件 |
|---|---|
プロパティに、HtmlSelect コントロール内の項目数を上回る値または -1 未満の値が設定されました。 |
解説
SelectedIndex プロパティは通常、単一選択 HtmlSelect コントロールで選択された項目のインデックスを確認するために使用されます。このインデックスを使用して Items コレクションから項目を取得できます。
Multiple プロパティが、複数の項目を同時に選択できることを示す true に設定されている場合、SelectedIndex プロパティには最初に選択した項目のインデックスが格納されます。複数の同時選択ができる HtmlSelect コントロールで選択された項目を確認するには、Items コレクションを反復処理して各項目の ListItem.Selected プロパティをテストします。
.gif) 注意 : |
|---|
項目を選択しなくてもかまいません。項目を選択しなかった場合、SelectedIndex プロパティは -1 の値を格納します。これは通常、最初にページが読み込まれ、既定で項目が選択されていない場合に発生します。Items コレクションの項目を参照する前にこの値をテストするコードを作成します。そうしない場合、インデックスがコレクションの範囲外の場合に例外がスローされます。 |
既定では、HtmlSelect コントロールはドロップダウン リスト ボックスとして表示されます。Multiple プロパティを true に設定して、複数の項目を選択できるようにした場合、または Size プロパティを 1 を超える値に設定して、高さを 1 行の高さよりも高く指定した場合、このコントロールはリスト ボックスとして表示されます。ドロップダウン リスト ボックスが表示される場合は、常に 1 つの項目が選択されています。リスト ボックスが表示された場合は、SelectedIndex プロパティを -1 に設定することによって、すべての項目の選択をプログラムで解除できます。
使用例
SelectedIndex プロパティを使用して、HtmlSelect コントロールで選択された項目のインデックスを確認する方法を次のコード例に示します。このインデックスを使用して Items コレクションから選択された項目を取得します。
<%@ 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>
<%@ 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="JScript" 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">
function Button_Click (sender : Object, e: EventArgs) : void
{
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>
プラットフォーム
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0
参照
関連項目
HtmlSelect クラス
HtmlSelect メンバ
System.Web.UI.HtmlControls 名前空間
HtmlSelect.Items プロパティ
ListItem.Selected
HtmlSelect.Multiple プロパティ
Size