HtmlSelect.SelectedIndex プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As HtmlSelect Dim value As Integer value = instance.SelectedIndex instance.SelectedIndex = value
/** @property */ public int get_SelectedIndex () /** @property */ public void set_SelectedIndex (int value)
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" %> <html> <head> <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 runat="server"> <h3> HtmlSelect Example </h3> Select items from the list: <br><br> <select id="Select1" Multiple="False" runat="server"> <option value="Text for Item 1" Selected="True"> 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" %> <html> <head> <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 runat="server"> <h3> HtmlSelect Example </h3> Select items from the list: <br><br> <select id="Select1" Multiple="False" runat="server"> <option value="Text for Item 1" Selected="True"> 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" %> <html> <head> <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 runat="server"> <h3> HtmlSelect Example </h3> Select items from the list: <br><br> <select id="Select1" Multiple="False" runat="server"> <option value="Text for Item 1" Selected="True"> 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 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- HtmlSelect.SelectedIndex プロパティのページへのリンク
