HtmlSelect イベント
パブリック イベント| 名前 | 説明 | |
|---|---|---|
.gif) | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
| | ServerChange | HtmlSelect コントロールで選択された項目がサーバーへのポスト間で変更された場合に発生します。 |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
参照関連項目
HtmlSelect クラスSystem.Web.UI.HtmlControls 名前空間
HtmlSelect.Size プロパティ
HtmlSelect.Multiple プロパティ
HtmlSelect.SelectedIndex プロパティ
HtmlSelect.Items プロパティ
System.Web.UI.WebControls.ListItem
System.Web.UI.WebControls.ListItemCollection
HtmlSelect.DataSource プロパティ
HtmlSelect.DataSourceID プロパティ
HtmlSelect.DataMember プロパティ
System.Data.DataSet
HtmlSelect.DataTextField プロパティ
ListItem.Text
HtmlSelect.DataValueField プロパティ
ListItem.Value
HtmlSelect.InnerHtml プロパティ
HtmlSelect.InnerText プロパティ
その他の技術情報
HTML サーバー コントロールHtmlSelect クラス
サーバー上の HTML <select> 要素にプログラムによってアクセスできるようにします。
名前空間: System.Web.UI.HtmlControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
.NET Framework のセキュリティ
継承階層
スレッド セーフ
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文<ValidationPropertyAttribute("Value")> _ Public Class HtmlSelect Inherits HtmlContainerControl Implements IPostBackDataHandler, IParserAccessor
[ValidationPropertyAttribute("Value")]
public class HtmlSelect : HtmlContainerControl,
IPostBackDataHandler, IParserAccessor
[ValidationPropertyAttribute(L"Value")] public ref class HtmlSelect : public HtmlContainerControl, IPostBackDataHandler, IParserAccessor
解説HtmlSelect コントロールを使用して選択ボックスを作成します。HTML <option> 要素を <select> の開始タグおよび終了タグの間に配置して、コントロールの項目一覧を指定します。各項目は System.Web.UI.WebControls.ListItem オブジェクトで表されます。コントロールの各項目に表示されるテキストを指定するには、項目の ListItem.Text プロパティを設定するか、または <option> の開始タグおよび終了タグの間にテキストを配置します。項目の ListItem.Value プロパティを設定することにより、値をテキストとは異なる項目に関連付けることができます。既定で一覧から項目を選択するには、項目の ListItem.Selected プロパティを true に設定します。
Size プロパティと Multiple プロパティを設定すると、HtmlSelect コントロールの外観と動作を制御できます。Size プロパティはコントロールの高さを行単位で指定します。Multiple プロパティは、HtmlSelect コントロールで複数の項目を同時に選択できるかどうかを指定します。
既定では、HtmlSelect コントロールはドロップダウン リスト ボックスとして表示されます。Multiple プロパティを true に設定して、複数の項目を選択できるようにした場合、または Size プロパティを 1 を超える値に設定して、高さを 1 行の高さよりも高く指定した場合、このコントロールはリスト ボックスとして表示されます。
単一選択の HtmlSelect コントロールで選択された項目を確認するには、SelectedIndex プロパティを使用して選択された項目のインデックスを取得します。この値を使用して Items コレクションから項目を取得できます。
複数選択ができる HtmlSelect コントロールで選択された項目を確認するには、Items コレクションを反復処理して各項目の ListItem.Selected プロパティをテストします。
HtmlSelect クラスには、データ バインディングをサポートする 2 つのプロパティが用意されています。System.Collections.IEnumerable インターフェイスを実装するオブジェクト (System.Data.DataView、System.Collections.ArrayList、System.Collections.Hashtable など) または IListSource インターフェイスを実装するオブジェクトにデータをバインドするには、DataSource プロパティを使用して、バインドするデータ ソースを指定します。DataSource プロパティを設定する場合は、データ バインディングを実行するコードを手動で記述する必要があります。データ ソース コントロールで表されるデータ ソースを HtmlSelect コントロールに自動的にバインドするには、DataSourceID プロパティを使用し、その値を、使用するデータ ソース コントロールの ID プロパティに設定します。DataSourceID プロパティを設定すると、HtmlSelect コントロールは、指定したデータ ソース コントロールに自動的にバインドされます。したがって、DataBind メソッドを明示的に呼び出す必要はありません。
コントロール内の項目の ListItem.Text プロパティおよび ListItem.Value プロパティにデータ ソースのどのフィールドをバインドするかは、DataTextField プロパティと DataValueField プロパティを個別に設定しても指定できます。データ ソースに格納されているデータのソースが複数の場合は、DataMember プロパティを使用して、コントロールにバインドする特定のソースを指定します。たとえば、複数のテーブルに System.Data.DataSet オブジェクトがある場合、どのテーブルをコントロールにバインドするかを DataMember プロパティを使用して指定する必要があります。
HtmlSelect のインスタンスの初期プロパティ値の一覧については、HtmlSelect コンストラクタのトピックを参照してください。
使用例コントロールに表示する項目を明示的に宣言することで HtmlSelect コントロールを作成する方法を次のコード例に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Sub Button_Click (sender As Object, e As EventArgs) Dim i As Integer Label1.Text = "You selected:" For i = 0 to Select1.Items.Count - 1 If Select1.Items(i).Selected Then Label1.Text = Label1.Text & "<br> -" & Select1.Items(i).Text End If Next i End Sub </script> </head> <body> <form runat="server"> <h3> HtmlSelect Example </h3> Select items from the list: <br><br> <select id="Select1" Multiple="True" runat="server"> <option value="1" Selected="True"> Item 1 </option> <option value="2"> Item 2 </option> <option value="3"> Item 3 </option> <option value="4"> Item 4 </option> <option value="5"> Item 5 </option> <option value="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:"; for (int i=0; i<=Select1.Items.Count - 1; i++) { if (Select1.Items[i].Selected) Label1.Text += "<br> -" + Select1.Items[i].Text; } } </script> </head> <body> <form runat="server"> <h3> HtmlSelect Example </h3> Select items from the list: <br><br> <select id="Select1" Multiple="True" runat="server"> <option value="1" Selected="True"> Item 1 </option> <option value="2"> Item 2 </option> <option value="3"> Item 3 </option> <option value="4"> Item 4 </option> <option value="5"> Item 5 </option> <option value="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) { Label1.Text = "You selected:"; for (var i : int = 0; i <= Select1.Items.Count - 1; i++) { if (Select1.Items[i].Selected) Label1.Text += "<br> -" + Select1.Items[i].Text; } } </script> </head> <body> <form runat="server"> <h3> HtmlSelect Example </h3> Select items from the list: <br><br> <select id="Select1" Multiple="True" runat="server"> <option value="1" Selected="True"> Item 1 </option> <option value="2"> Item 2 </option> <option value="3"> Item 3 </option> <option value="4"> Item 4 </option> <option value="5"> Item 5 </option> <option value="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>
コントロールをデータ ソースにバインドすることにより HtmlSelect コントロールを作成する方法を次のコード例に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <%@ Import Namespace="System.Data.SqlClient" %> <html> <head> <script runat="server"> Sub Page_Load (sender As Object, e As EventArgs) ' Bind the HtmlSelect control to a data source when the page is initially loaded. If Not IsPostBack Then ' Open a connection to the database and run the query. ' Note that the connection string may vary depending on your ' database server settings. Dim ConnectString As String = "server=localhost;database=pubs;integrated security=SSPI" Dim QueryString As String = "select * from authors" Dim myConnection As SqlConnection = New SqlConnection(ConnectString) Dim myCommand As SqlDataAdapter = New SqlDataAdapter(QueryString, myConnection) ' Create a dataset to store the query results. Dim ds As DataSet = New DataSet() myCommand.Fill(ds, "Authors") ' Bind the HtmlSelect control to the data source. Select1.DataSource = ds Select1.DataTextField = "au_fname" Select1.DataValueField = "au_fname" Select1.DataBind() End If End Sub Sub Button_Click (sender As Object, e As EventArgs) Dim i As Integer Label1.Text = "You selected:" For i = 0 To Select1.Items.Count - 1 If Select1.Items(i).Selected Then Label1.Text = Label1.Text & "<br> - " & Select1.Items(i).Text End If Next i End Sub </script> </head> <body> <form runat="server"> <h3> HtmlSelect Example </h3> Select items from the list. <br> Use the Control or Shift key to select multiple items. <br><br> <select id="Select1" Multiple="True" runat="server"/> <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" %> <%@ Import Namespace="System.Data" %> <%@ Import Namespace="System.Data.SqlClient" %> <html> <head> <script runat="server"> void Page_Load (Object sender, EventArgs e) { // Bind the HtmlSelect control to a data source when the page is initially loaded. if (!IsPostBack) { // Open a connection to the database and run the query. // Note that the connection string may vary depending on your // database server settings. string ConnectString = "server=localhost;database=pubs;integrated security=SSPI"; string QueryString = "select * from authors"; SqlConnection myConnection = new SqlConnection(ConnectString); SqlDataAdapter myCommand = new SqlDataAdapter(QueryString, myConnection); // Create a dataset to store the query results. DataSet ds = new DataSet(); myCommand.Fill(ds, "Authors"); // Bind the HtmlSelect control to the data source. Select1.DataSource = ds; Select1.DataTextField = "au_fname"; Select1.DataValueField = "au_fname"; Select1.DataBind(); } } void Button_Click (Object sender, EventArgs e) { // Display the selected items. Label1.Text = "You selected:"; for (int i=0; i<=Select1.Items.Count - 1; i++) { if (Select1.Items[i].Selected) Label1.Text += "<br> - " + Select1.Items[i].Text; } } </script> </head> <body> <form runat="server"> <h3> HtmlSelect Example </h3> Select items from the list. <br> Use the Control or Shift key to select multiple items. <br><br> <select id="Select1" Multiple="True" runat="server"/> <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" %> <%@ Import Namespace="System.Data" %> <%@ Import Namespace="System.Data.SqlClient" %> <html> <head> <script runat="server"> function Page_Load (sender : Object, e : EventArgs) : void { // Bind the HtmlSelect control to a data source when the page is initially loaded. if (!IsPostBack) { // Open a connection to the database and run the query. // Note that the connection string may vary depending on your // database server settings. var ConnectString : String = "server=localhost;database=pubs;integrated security=SSPI"; var QueryString : String = "select * from authors"; var myConnection : SqlConnection = new SqlConnection(ConnectString); var myCommand : SqlDataAdapter = new SqlDataAdapter(QueryString, myConnection); // Create a dataset to store the query results. var ds : DataSet = new DataSet(); myCommand.Fill(ds, "Authors"); // Bind the HtmlSelect control to the data source. Select1.DataSource = ds; Select1.DataTextField = "au_fname"; Select1.DataValueField = "au_fname"; Select1.DataBind(); } } function Button_Click (sender : Object, e : EventArgs) : void { // Display the selected items. Label1.Text = "You selected:"; for (var i: int=0; i<=Select1.Items.Count - 1; i++) { if (Select1.Items[i].Selected) Label1.Text += "<br> - " + Select1.Items[i].Text; } } </script> </head> <body> <form runat="server"> <h3> HtmlSelect Example </h3> Select items from the list. <br> Use the Control or Shift key to select multiple items. <br><br> <select id="Select1" Multiple="True" runat="server"/> <br><br> <button id="Button1" OnServerClick="Button_Click" runat="server"> Submit </button> <br><br> <asp:Label id="Label1" runat="server"/> </form> </body> </html>
DataSourceID プロパティを使用して、HtmlSelect コントロールのデータ ソースを指定する方法を次のコード例に示します。DataSourceID プロパティは、データの取得に使用する SqlDataSource コントロールの ID プロパティに設定されます。ページが読み込まれると、HtmlSelect コントロールは、SqlDataSource コントロールによって指定されたデータ ソースに自動的にバインドされ、ユーザーにデータが表示されます。
<%@ page language="VB" %> <html> <head runat="server"> <title>HtmlSelect.DataSourceID</title> </head> <body> <form id="Form1" runat="server"> <h3> HtmlSelect.DataSourceID Example </h3> <p>Select an item from the list</p> <select id="Select1" name="Select1" DataSourceId="SqlDataSource1" DataTextField="ProductName" runat="server"> </select> <asp:sqldatasource id="SqlDataSource1" connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind" selectcommand="SELECT * FROM [Products] Where ProductID <= 5" runat="server"> </asp:sqldatasource> </form> </body> </html>
<%@ page language="C#" %> <html> <head id="Head1" runat="server"> <title>HtmlSelect.DataSourceID</title> </head> <body> <form id="Form1" runat="server"> <h3> HtmlSelect.DataSourceID Example </h3> <p>Select an item from the list</p> <select id="Select1" name="Select1" DataSourceId="SqlDataSource1" datatextfield="ProductName" runat="server"> </select> <asp:sqldatasource id="SqlDataSource1" connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind" selectcommand="SELECT * FROM [Products] Where ProductID <= 5" runat="server"> </asp:sqldatasource> </form> </body> </html>
.NET Framework のセキュリティ継承階層
System.Object
System.Web.UI.Control
System.Web.UI.HtmlControls.HtmlControl
System.Web.UI.HtmlControls.HtmlContainerControl
System.Web.UI.HtmlControls.HtmlSelect
System.Web.UI.Control
System.Web.UI.HtmlControls.HtmlControl
System.Web.UI.HtmlControls.HtmlContainerControl
System.Web.UI.HtmlControls.HtmlSelect
スレッド セーフプラットフォーム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 メンバ
System.Web.UI.HtmlControls 名前空間
Size
Multiple
SelectedIndex
Items
System.Web.UI.WebControls.ListItem
System.Web.UI.WebControls.ListItemCollection
DataSource
DataSourceID
DataMember
System.Data.DataSet
DataTextField
ListItem.Text
DataValueField
ListItem.Value
InnerHtml
InnerText
その他の技術情報
HTML サーバー コントロール
HtmlSelect メンバ
System.Web.UI.HtmlControls 名前空間
Size
Multiple
SelectedIndex
Items
System.Web.UI.WebControls.ListItem
System.Web.UI.WebControls.ListItemCollection
DataSource
DataSourceID
DataMember
System.Data.DataSet
DataTextField
ListItem.Text
DataValueField
ListItem.Value
InnerHtml
InnerText
その他の技術情報
HTML サーバー コントロール
HtmlSelect コンストラクタ
HtmlSelect クラスの新しいインスタンスを初期化します。
名前空間: System.Web.UI.HtmlControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文解説使用例HtmlSelect コントロールのインスタンスを動的に作成して Web ページに配置する方法を次のコード例に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <script runat="server" > Sub Page_Load(sender As Object, e As EventArgs) ' Create an HtmlSelect control. Dim selectlist As HtmlSelect = New HtmlSelect() ' Populate the HtmlSelect control. Dim i As Integer For i=0 to 4 Dim item As ListItem = _ New ListItem("Item " + i.ToString(), i.ToString()) selectlist.Items.Add(item) Next i ' Add the control to the Controls collection of the ' PlaceHolder control. Place.Controls.Clear() Place.Controls.Add(selectlist) End Sub </script> <body> <form runat="server"> <h3> HtmlSelect Constructor Example </h3> <asp:PlaceHolder id="Place" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <script runat="server" > void Page_Load(Object sender, EventArgs e) { // Create an HtmlSelect control. HtmlSelect selectlist = new HtmlSelect(); // Populate the HtmlSelect control. for(int i=0; i<5; i++) { ListItem item = new ListItem("Item " + i.ToString(), i.ToString()); selectlist.Items.Add(item); } // Add the control to the Controls collection of the // PlaceHolder control. Place.Controls.Clear(); Place.Controls.Add(selectlist); } </script> <body> <form runat="server"> <h3> HtmlSelect Constructor Example </h3> <asp:PlaceHolder id="Place" 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 プロパティ
パブリック プロパティ
(
プロテクト プロパティ
も参照)
.gif)
プロテクト プロパティ.gif)
参照関連項目
HtmlSelect クラスSystem.Web.UI.HtmlControls 名前空間
Size
Multiple
SelectedIndex
Items
System.Web.UI.WebControls.ListItem
System.Web.UI.WebControls.ListItemCollection
DataSource
DataSourceID
DataMember
System.Data.DataSet
DataTextField
ListItem.Text
DataValueField
ListItem.Value
InnerHtml
InnerText
その他の技術情報
HTML サーバー コントロールHtmlSelect メソッド
パブリック メソッド
(
プロテクト メソッド
も参照)
.gif)
プロテクト メソッド.gif)
明示的インターフェイスの実装| 名前 | 説明 | |
|---|---|---|
.gif) | System.Web.UI.IPostBackDataHandler.LoadPostData | このメンバの説明については、IPostBackDataHandler.LoadPostData のトピックを参照してください。 |
| | System.Web.UI.IPostBackDataHandler.RaisePostDataChangedEvent | このメンバの説明については、IPostBackDataHandler.RaisePostDataChangedEvent のトピックを参照してください。 |
参照関連項目
HtmlSelect クラスSystem.Web.UI.HtmlControls 名前空間
Size
Multiple
SelectedIndex
Items
System.Web.UI.WebControls.ListItem
System.Web.UI.WebControls.ListItemCollection
DataSource
DataSourceID
DataMember
System.Data.DataSet
DataTextField
ListItem.Text
DataValueField
ListItem.Value
InnerHtml
InnerText
その他の技術情報
HTML サーバー コントロールHtmlSelect メンバ
サーバー上の HTML <select> 要素にプログラムによってアクセスできるようにします。
HtmlSelect データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック プロパティ
(
プロテクト プロパティ
も参照)
プロテクト プロパティパブリック メソッド
(
プロテクト メソッド
も参照)
プロテクト メソッドパブリック イベント| 名前 | 説明 | |
|---|---|---|
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
| | ServerChange | HtmlSelect コントロールで選択された項目がサーバーへのポスト間で変更された場合に発生します。 |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
明示的インターフェイスの実装| 名前 | 説明 | |
|---|---|---|
| | System.Web.UI.IPostBackDataHandler.LoadPostData | このメンバの説明については、IPostBackDataHandler.LoadPostData のトピックを参照してください。 |
| | System.Web.UI.IPostBackDataHandler.RaisePostDataChangedEvent | このメンバの説明については、IPostBackDataHandler.RaisePostDataChangedEvent のトピックを参照してください。 |
参照関連項目
HtmlSelect クラスSystem.Web.UI.HtmlControls 名前空間
Size
Multiple
SelectedIndex
Items
System.Web.UI.WebControls.ListItem
System.Web.UI.WebControls.ListItemCollection
DataSource
DataSourceID
DataMember
System.Data.DataSet
DataTextField
ListItem.Text
DataValueField
ListItem.Value
InnerHtml
InnerText
その他の技術情報
HTML サーバー コントロール- HtmlSelectのページへのリンク
