ドロップダウン‐リスト【drop-down list】
読み方：どろっぷだうんりすと
DropDownList イベント
パブリック イベント| 名前 | 説明 | |
|---|---|---|
.gif) | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
| | DataBound | サーバー コントロールがデータ ソースにバインドした後に発生します。 ( BaseDataBoundControl から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
| | SelectedIndexChanged | リスト コントロール内の選択項目がサーバーへのポスト間で変更された場合に発生します。 ( ListControl から継承されます。) |
| | TextChanged | Text プロパティと SelectedValue プロパティが変更された場合に発生します。 ( ListControl から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
参照DropDownList クラス
ユーザーがドロップダウン リストから単一の項目を選択できるコントロールを表します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
.NET Framework のセキュリティ
継承階層
スレッド セーフ
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文<ValidationPropertyAttribute("SelectedItem")> _ Public Class DropDownList Inherits ListControl Implements IPostBackDataHandler
[ValidationPropertyAttribute("SelectedItem")]
public class DropDownList : ListControl, IPostBackDataHandler
[ValidationPropertyAttribute(L"SelectedItem")] public ref class DropDownList : public ListControl, IPostBackDataHandler
解説DropDownList コントロールを使用して、単一選択ドロップダウン リスト コントロールを作成します。BorderColor、BorderStyle、BorderWidth の各プロパティを設定すると DropDownList コントロールの外観を制御できます。
DropDownList コントロールに表示する項目を指定するには、各エントリに対して、DropDownList コントロールの開始タグと終了タグの間に ListItem オブジェクトを配置します。
DropDownList コントロールはデータ連結もサポートしています。コントロールをデータ ソースにバインドするには、コントロールに表示する項目を格納している System.Collections.ArrayList オブジェクトなどのデータ ソースを作成します。データ ソースを作成したら、Control.DataBind メソッドを使用してデータ ソースを DropDownList コントロールに連結します。
SelectedIndex プロパティを使用して、DropDownList コントロールからユーザーが選択した項目のインデックスをプログラムにより確認します。
ユーザー補助このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。
使用例4 つの項目が格納されている DropDownList コントロールを作成する方法を次のコード例に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <script runat="server" > Sub Selection_Change(sender As Object, e As EventArgs) ' Set the background color for days in the Calendar control ' based on the value selected by the user from the ' DropDownList control. Calendar1.DayStyle.BackColor = _ System.Drawing.Color.FromName(ColorList.SelectedItem.Value) End Sub </script> <body> <form runat="server"> <h3> DropDownList Example </h3> Select a background color for days in the calendar. <br><br> <asp:Calendar id="Calendar1" ShowGridLines="True" ShowTitle="True" runat="server"/> <br><br> <table cellpadding="5"> <tr> <td> Background color: </td> </tr> <tr> <td> <asp:DropDownList id="ColorList" AutoPostBack="True" OnSelectedIndexChanged="Selection_Change" runat="server"> <asp:ListItem Selected="True" Value="White"> White </asp:ListItem> <asp:ListItem Value="Silver"> Silver </asp:ListItem> <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem> <asp:ListItem Value="Khaki"> Khaki </asp:ListItem> <asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem> </asp:DropDownList> </td> </tr> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <script runat="server" > void Selection_Change(Object sender, EventArgs e) { // Set the background color for days in the Calendar control // based on the value selected by the user from the // DropDownList control. Calendar1.DayStyle.BackColor = System.Drawing.Color.FromName(ColorList.SelectedItem.Value); } </script> <body> <form runat="server"> <h3> DropDownList Example </h3> Select a background color for days in the calendar. <br><br> <asp:Calendar id="Calendar1" ShowGridLines="True" ShowTitle="True" runat="server"/> <br><br> <table cellpadding="5"> <tr> <td> Background color: </td> </tr> <tr> <td> <asp:DropDownList id="ColorList" AutoPostBack="True" OnSelectedIndexChanged="Selection_Change" runat="server"> <asp:ListItem Selected="True" Value="White"> White </asp:ListItem> <asp:ListItem Value="Silver"> Silver </asp:ListItem> <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem> <asp:ListItem Value="Khaki"> Khaki </asp:ListItem> <asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem> </asp:DropDownList> </td> </tr> </form> </body> </html>
データ バインディングにより DropDownList コントロールを作成する方法を次のコード例に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server" > Sub Selection_Change(sender as Object, e As EventArgs) ' Set the background color for days in the Calendar control ' based on the value selected by the user from the ' DropDownList control. Calendar1.DayStyle.BackColor = _ System.Drawing.Color.FromName(ColorList.SelectedItem.Value) End Sub Sub Page_Load(sender as Object, e As EventArgs) ' Load data for the DropDownList control only once, when the ' page is first loaded. If Not IsPostBack Then ' Specify the data source and field names for the Text ' and Value properties of the items (ListItem objects) ' in the DropDownList control. ColorList.DataSource = CreateDataSource() ColorList.DataTextField = "ColorTextField" ColorList.DataValueField = "ColorValueField" ' Bind the data to the control. ColorList.DataBind() ' Set the default selected item, if desired. ColorList.SelectedIndex = 0 End If End Sub Function CreateDataSource() As ICollection ' Create a table to store data for the DropDownList control. Dim dt As DataTable = New DataTable() ' Define the columns of the table. dt.Columns.Add(new DataColumn("ColorTextField", GetType(String))) dt.Columns.Add(new DataColumn("ColorValueField", GetType(String))) ' Populate the table with sample values. dt.Rows.Add(CreateRow("White", "White", dt)) dt.Rows.Add(CreateRow("Silver", "Silver", dt)) dt.Rows.Add(CreateRow("Dark Gray", "DarkGray", dt)) dt.Rows.Add(CreateRow("Khaki", "Khaki", dt)) dt.Rows.Add(CreateRow("Dark Khaki", "DarkKhaki", dt)) ' Create a DataView from the DataTable to act as the data source ' for the DropDownList control. Dim dv As DataView = New DataView(dt) Return dv End Function Function CreateRow(Text As String, Value As String, dt As DataTable) As DataRow ' Create a DataRow using the DataTable defined in the ' CreateDataSource method. Dim dr As DataRow = dt.NewRow() ' This DataRow contains the ColorTextField and ColorValueField ' fields, as defined in the CreateDataSource method. Set the ' fields with the appropriate value. Remember that column 0 ' is defined as ColorTextField, and column 1 is defined as ' ColorValueField. dr(0) = Text dr(1) = Value Return dr End Function </script> <body> <form runat="server"> <h3> DropDownList Data Binding Example </h3> Select a background color for days in the calendar. <br><br> <asp:Calendar id="Calendar1" ShowGridLines="True" ShowTitle="True" runat="server"/> <br><br> <table cellpadding="5"> <tr> <td> Background color: </td> </tr> <tr> <td> <asp:DropDownList id="ColorList" AutoPostBack="True" OnSelectedIndexChanged="Selection_Change" runat="server"/> </td> </tr> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server" > void Selection_Change(Object sender, EventArgs e) { // Set the background color for days in the Calendar control // based on the value selected by the user from the // DropDownList control. Calendar1.DayStyle.BackColor = System.Drawing.Color.FromName(ColorList.SelectedItem.Value); } void Page_Load(Object sender, EventArgs e) { // Load data for the DropDownList control only once, when the // page is first loaded. if(!IsPostBack) { // Specify the data source and field names for the Text // and Value properties of the items (ListItem objects) // in the DropDownList control. ColorList.DataSource = CreateDataSource(); ColorList.DataTextField = "ColorTextField"; ColorList.DataValueField = "ColorValueField"; // Bind the data to the control. ColorList.DataBind(); // Set the default selected item, if desired. ColorList.SelectedIndex = 0; } } ICollection CreateDataSource() { // Create a table to store data for the DropDownList control. DataTable dt = new DataTable(); // Define the columns of the table. dt.Columns.Add(new DataColumn("ColorTextField", typeof(String))); dt.Columns.Add(new DataColumn("ColorValueField", typeof(String))); // Populate the table with sample values. dt.Rows.Add(CreateRow("White", "White", dt)); dt.Rows.Add(CreateRow("Silver", "Silver", dt)); dt.Rows.Add(CreateRow("Dark Gray", "DarkGray", dt)); dt.Rows.Add(CreateRow("Khaki", "Khaki", dt)); dt.Rows.Add(CreateRow("Dark Khaki", "DarkKhaki", dt)); // Create a DataView from the DataTable to act as the data source // for the DropDownList control. DataView dv = new DataView(dt); return dv; } DataRow CreateRow(String Text, String Value, DataTable dt) { // Create a DataRow using the DataTable defined in the // CreateDataSource method. DataRow dr = dt.NewRow(); // This DataRow contains the ColorTextField and ColorValueField // fields, as defined in the CreateDataSource method. Set the // fields with the appropriate value. Remember that column 0 // is defined as ColorTextField, and column 1 is defined as // ColorValueField. dr[0] = Text; dr[1] = Value; return dr; } </script> <body> <form runat="server"> <h3> DropDownList Data Binding Example </h3> Select a background color for days in the calendar. <br><br> <asp:Calendar id="Calendar1" ShowGridLines="True" ShowTitle="True" runat="server"/> <br><br> <table cellpadding="5"> <tr> <td> Background color: </td> </tr> <tr> <td> <asp:DropDownList id="ColorList" AutoPostBack="True" OnSelectedIndexChanged="Selection_Change" runat="server"/> </td> </tr> </form> </body> </html>
.NET Framework のセキュリティ継承階層
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.BaseDataBoundControl
System.Web.UI.WebControls.DataBoundControl
System.Web.UI.WebControls.ListControl
System.Web.UI.WebControls.DropDownList
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.BaseDataBoundControl
System.Web.UI.WebControls.DataBoundControl
System.Web.UI.WebControls.ListControl
System.Web.UI.WebControls.DropDownList
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DropDownList コンストラクタ
DropDownList クラスの新しいインスタンスを初期化します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文解説使用例DropDownList クラスの新しいインスタンスを作成および初期化する方法を次のコード例に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server" > Sub Selection_Change(sender as Object, e As EventArgs) ' Retrieve the DropDownList control from the Controls ' collection of the PlaceHolder control. Dim DropList As DropDownList = _ CType(Place.FindControl("ColorList"), DropDownList) ' Set the background color for days in the Calendar control ' based on the value selected by the user from the ' DropDownList control. Calendar1.DayStyle.BackColor = _ System.Drawing.Color.FromName(DropList.SelectedItem.Value) End Sub Sub Page_Load(sender as Object, e As EventArgs) ' Create a DropDownList control. Dim DropList As DropDownList = New DropDownList() ' Set the properties for the DropDownList control. DropList.ID = "ColorList" DropList.AutoPostBack = True ' Manually register the event-handling method for the ' SelectedIndexChanged event. AddHandler DropList.SelectedIndexChanged, AddressOf Selection_Change ' Because the DropDownList control is created dynamically each ' time the page is loaded, the data must be bound to the ' control each time the page is refreshed. ' Specify the data source and field names for the Text and ' Value properties of the items (ListItem objects) in the ' DropDownList control. DropList.DataSource = CreateDataSource() DropList.DataTextField = "ColorTextField" DropList.DataValueField = "ColorValueField" ' Bind the data to the control. DropList.DataBind() ' Set the default selected item when the page is first loaded. If Not IsPostBack Then DropList.SelectedIndex = 0 End If ' Add the DropDownList control to the Controls collection of ' the PlaceHolder control. Place.Controls.Add(DropList) End Sub Function CreateDataSource() As ICollection ' Create a table to store data for the DropDownList control. Dim dt As DataTable = New DataTable() ' Define the columns of the table. dt.Columns.Add(new DataColumn("ColorTextField", GetType(String))) dt.Columns.Add(new DataColumn("ColorValueField", GetType(String))) ' Populate the table with sample values. dt.Rows.Add(CreateRow("White", "White", dt)) dt.Rows.Add(CreateRow("Silver", "Silver", dt)) dt.Rows.Add(CreateRow("Dark Gray", "DarkGray", dt)) dt.Rows.Add(CreateRow("Khaki", "Khaki", dt)) dt.Rows.Add(CreateRow("Dark Khaki", "DarkKhaki", dt)) ' Create a DataView from the DataTable to act as the data source ' for the DropDownList control. Dim dv As DataView = New DataView(dt) Return dv End Function Function CreateRow(Text As String, Value As String, dt As DataTable) As DataRow ' Create a DataRow using the DataTable defined in the ' CreateDataSource method. Dim dr As DataRow = dt.NewRow() ' This DataRow contains the ColorTextField and ColorValueField ' fields, as defined in the CreateDataSource method. Set the ' fields with the appropriate value. Remember that column 0 ' is defined as ColorTextField, and column 1 is defined as ' ColorValueField. dr(0) = Text dr(1) = Value Return dr End Function </script> <body> <form runat="server"> <h3> DropDownList Constructor Example </h3> Select a background color for days in the calendar. <br><br> <asp:Calendar id="Calendar1" ShowGridLines="True" ShowTitle="True" runat="server"/> <br><br> <table cellpadding="5"> <tr> <td> Background color: </td> </tr> <tr> <td> <asp:PlaceHolder id="Place" runat="server"/> </td> </tr> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server" > void Selection_Change(Object sender, EventArgs e) { // Retrieve the DropDownList control from the Controls // collection of the PlaceHolder control. DropDownList DropList = (DropDownList)Place.FindControl("ColorList"); // Set the background color for days in the Calendar control // based on the value selected by the user from the // DropDownList control. Calendar1.DayStyle.BackColor = System.Drawing.Color.FromName(DropList.SelectedItem.Value); } void Page_Load(Object sender, EventArgs e) { // Create a DropDownList control. DropDownList DropList = new DropDownList(); // Set the properties for the DropDownList control. DropList.ID = "ColorList"; DropList.AutoPostBack = true; // Manually register the event-handling method for the // SelectedIndexChanged event. DropList.SelectedIndexChanged += new EventHandler(this.Selection_Change); // Because the DropDownList control is created dynamically each // time the page is loaded, the data must be bound to the // control each time the page is refreshed. // Specify the data source and field names for the Text and // Value properties of the items (ListItem objects) in the // DropDownList control. DropList.DataSource = CreateDataSource(); DropList.DataTextField = "ColorTextField"; DropList.DataValueField = "ColorValueField"; // Bind the data to the control. DropList.DataBind(); // Set the default selected item when the page is first loaded. if(!IsPostBack) { DropList.SelectedIndex = 0; } // Add the DropDownList control to the Controls collection of // the PlaceHolder control. Place.Controls.Add(DropList); } ICollection CreateDataSource() { // Create a table to store data for the DropDownList control. DataTable dt = new DataTable(); // Define the columns of the table. dt.Columns.Add(new DataColumn("ColorTextField", typeof(String))); dt.Columns.Add(new DataColumn("ColorValueField", typeof(String))); // Populate the table with sample values. dt.Rows.Add(CreateRow("White", "White", dt)); dt.Rows.Add(CreateRow("Silver", "Silver", dt)); dt.Rows.Add(CreateRow("Dark Gray", "DarkGray", dt)); dt.Rows.Add(CreateRow("Khaki", "Khaki", dt)); dt.Rows.Add(CreateRow("Dark Khaki", "DarkKhaki", dt)); // Create a DataView from the DataTable to act as the data source // for the DropDownList control. DataView dv = new DataView(dt); return dv; } DataRow CreateRow(String Text, String Value, DataTable dt) { // Create a DataRow using the DataTable defined in the // CreateDataSource method. DataRow dr = dt.NewRow(); // This DataRow contains the ColorTextField and ColorValueField // fields, as defined in the CreateDataSource method. Set the // fields with the appropriate value. Remember that column 0 // is defined as ColorTextField, and column 1 is defined as // ColorValueField. dr[0] = Text; dr[1] = Value; return dr; } </script> <body> <form runat="server"> <h3> DropDownList Constructor Example </h3> Select a background color for days in the calendar. <br><br> <asp:Calendar id="Calendar1" ShowGridLines="True" ShowTitle="True" runat="server"/> <br><br> <table cellpadding="5"> <tr> <td> Background color: </td> </tr> <tr> <td> <asp:PlaceHolder id="Place" runat="server"/> </td> </tr> </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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DropDownList プロパティ
パブリック プロパティ
(
プロテクト プロパティ
も参照)
.gif)
プロテクト プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | Adapter | コントロール用のブラウザ固有のアダプタを取得します。 ( Control から継承されます。) |
| | ChildControlsCreated | サーバー コントロールの子コントロールが作成されたかどうかを示す値を取得します。 ( Control から継承されます。) |
| | ClientIDSeparator | ClientID プロパティで使用される区切り記号を表す文字値を取得します。 ( Control から継承されます。) |
| | Context | 現在の Web 要求に対するサーバー コントロールに関連付けられている HttpContext オブジェクトを取得します。 ( Control から継承されます。) |
| | DesignMode | コントロールがデザイン サーフェイスで使用されているかどうかを示す値を取得します。 ( Control から継承されます。) |
| | Events | コントロールのイベント ハンドラ デリゲートのリストを取得します。このプロパティは読み取り専用です。 ( Control から継承されます。) |
| | HasChildViewState | 現在のサーバー コントロールの子コントロールが、保存されたビューステートの設定を持っているかどうかを示す値を取得します。 ( Control から継承されます。) |
| | IdSeparator | コントロール ID を区別するために使用する文字を取得します。 ( Control から継承されます。) |
| | Initialized | データ バインド コントロールが初期化されているかどうかを示す値を取得します。 ( BaseDataBoundControl から継承されます。) |
| | IsBoundUsingDataSourceID | DataSourceID プロパティが設定されているかどうか示す値を取得します。 ( BaseDataBoundControl から継承されます。) |
| | IsChildControlStateCleared | このコントロールに含まれているコントロールに、コントロールの状態が設定されているかどうかを示す値を取得します。 ( Control から継承されます。) |
| | IsEnabled | コントロールが有効かどうかを示す値を取得します。 ( WebControl から継承されます。) |
| | IsTrackingViewState | サーバー コントロールがビューステートの変更を保存しているかどうかを示す値を取得します。 ( Control から継承されます。) |
| | IsViewStateEnabled | このコントロールでビューステートが有効かどうかを示す値を取得します。 ( Control から継承されます。) |
| | LoadViewStateByID | コントロールがインデックスではなく ID によりビューステートの読み込みを行うかどうかを示す値を取得します。 ( Control から継承されます。) |
| | RequiresDataBinding | DataBind メソッドを呼び出す必要があるかどうか示す値を取得または設定します。 ( BaseDataBoundControl から継承されます。) |
| | SelectArguments | データ ソース コントロールからデータを取得するときにデータ バインド コントロールが使用する DataSourceSelectArguments オブジェクトを取得します。 ( DataBoundControl から継承されます。) |
| | TagKey | ListControl コントロールの HtmlTextWriterTag 値を取得します。 ( ListControl から継承されます。) |
| | TagName | コントロール タグの名前を取得します。このプロパティは、主にコントロールの開発者によって使用されます。 ( WebControl から継承されます。) |
| | ViewState | 同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 ( Control から継承されます。) |
| | ViewStateIgnoresCase | StateBag オブジェクトが大文字小文字を区別しないかどうかを示す値を取得します。 ( Control から継承されます。) |
参照DropDownList メソッド
パブリック メソッド
(
プロテクト メソッド
も参照)
.gif)
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | AddAttributesToRender | オーバーライドされます。 指定した HtmlTextWriter オブジェクトに表示する必要のある HTML 属性およびスタイルを追加します。 |
| | AddedControl | 子コントロールが Control オブジェクトの Controls コレクションに追加された後に呼び出されます。 ( Control から継承されます。) |
| | AddParsedSubObject | サーバー コントロールに、XML または HTML の要素が解析されたことを通知し、その要素をサーバー コントロールの ControlCollection オブジェクトに追加します。 ( Control から継承されます。) |
| | BuildProfileTree | ページのトレースが有効な場合、サーバー コントロールに関する情報を収集し、これを表示するために Trace プロパティに渡します。 ( Control から継承されます。) |
| | ClearChildControlState | サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。 ( Control から継承されます。) |
| | ClearChildState | サーバー コントロールのすべての子コントロールのビューステート情報およびコントロールの状態情報を削除します。 ( Control から継承されます。) |
| | ClearChildViewState | サーバー コントロールのすべての子コントロールのビューステート情報を削除します。 ( Control から継承されます。) |
| | ConfirmInitState | データ バインド コントロールの初期化状態を設定します。 ( BaseDataBoundControl から継承されます。) |
| | CreateChildControls | ASP.NET ページ フレームワークによって呼び出され、コンポジション ベースの実装を使用するサーバー コントロールに、ポスト バックまたは表示のための準備として、格納する子コントロールを作成するように通知します。 ( Control から継承されます。) |
| | CreateControlCollection | オーバーライドされます。 子コントロールを格納するコレクションを作成します。 |
| | CreateControlStyle | WebControl クラスで、すべてのスタイル関連プロパティを実装するために内部的に使用されるスタイル オブジェクトを作成します。このメソッドは、主にコントロールの開発者によって使用されます。 ( WebControl から継承されます。) |
| | CreateDataSourceSelectArguments | 引数が未指定の場合に、データ バインド コントロールが使用する既定の DataSourceSelectArguments オブジェクトを作成します。 ( DataBoundControl から継承されます。) |
| | DataBind | オーバーロードされます。 呼び出されたサーバー コントロールと、そのすべての子コントロールにデータ ソースを連結します。 ( Control から継承されます。) |
| | DataBindChildren | データ ソースをサーバー コントロールの子コントロールにバインドします。 ( Control から継承されます。) |
| | EnsureChildControls | サーバー コントロールに子コントロールが含まれているかどうかを確認します。含まれていない場合、子コントロールを作成します。 ( Control から継承されます。) |
| | EnsureDataBound | DataSourceID プロパティが設定されていて、データ バインド コントロールにバインディングが必要とマークされている場合に、DataBind メソッドを呼び出します。 ( BaseDataBoundControl から継承されます。) |
| | EnsureID | ID が割り当てられていないコントロールの ID を作成します。 ( Control から継承されます。) |
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | FindControl | オーバーロードされます。 指定したサーバー コントロールの現在の名前付けコンテナを検索します。 ( Control から継承されます。) |
| | GetData | データ操作を実行するために、データ バインド コントロールが使用する DataSourceView オブジェクトを取得します。 ( DataBoundControl から継承されます。) |
| | GetDataSource | データ バインド コントロールが関連付けられている IDataSource インターフェイスを取得します (存在する場合)。 ( DataBoundControl から継承されます。) |
| | GetDesignModeState | コントロールのデザイン時データを取得します。 ( Control から継承されます。) |
| | HasEvents | コントロールまたは子コントロールに対してイベントが登録されているかどうかを示す値を返します。 ( Control から継承されます。) |
| | IsLiteralContent | サーバー コントロールがリテラルな内容だけを保持しているかどうかを決定します。 ( Control から継承されます。) |
| | LoadControlState | SaveControlState メソッドによって保存された前回のページ要求からコントロールの状態情報を復元します。 ( Control から継承されます。) |
| | LoadPostData | DropDownList コントロールのポストバック データを処理します。 |
| | LoadViewState | 以前に保存した DetailsView コントロールのビューステートを読み込みます。 ( ListControl から継承されます。) |
| | MapPathSecure | 仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。 ( Control から継承されます。) |
| | MarkAsDataBound | ビューステートのコントロールの状態を、データに正常にバインドされた状態に設定します。 ( DataBoundControl から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
| | OnBubbleEvent | サーバー コントロールのイベントをページの UI サーバー コントロールの階層構造に渡すかどうかを決定します。 ( Control から継承されます。) |
| | OnDataBinding | DataBinding イベントを発生させます。 ( ListControl から継承されます。) |
| | OnDataBound | DataBound イベントを発生させます。 ( BaseDataBoundControl から継承されます。) |
| | OnDataPropertyChanged | 基本データ ソース識別プロパティのいずれかが変更された後、データ バインド コントロールをデータにバインドし直します。 ( DataBoundControl から継承されます。) |
| | OnDataSourceViewChanged | DataSourceViewChanged イベントを発生させます。 ( DataBoundControl から継承されます。) |
| | OnInit | Init イベントを処理します。 ( BaseDataBoundControl から継承されます。) |
| | OnLoad | Control.Load イベントを処理します。 ( DataBoundControl から継承されます。) |
| | OnPagePreLoad | コントロールが読み込まれる前に、データ バインド コントロールの初期化状態を設定します。 ( DataBoundControl から継承されます。) |
| | OnPreRender | PreRender イベントを発生させます。 ( ListControl から継承されます。) |
| | OnSelectedIndexChanged | SelectedIndexChanged イベントを発生させます。この機能により、イベントのカスタム ハンドラを作成できます。 ( ListControl から継承されます。) |
| | OnTextChanged | TextChanged イベントを発生させます。 ( ListControl から継承されます。) |
| | OnUnload | Unload イベントを発生させます。 ( Control から継承されます。) |
| | OpenFile | ファイルの読み込みで使用される Stream を取得します。 ( Control から継承されます。) |
| | PerformDataBinding | 指定したデータ ソースを、ListControl クラスから派生したコントロールにバインドします。 ( ListControl から継承されます。) |
| | PerformSelect | 関連するデータ ソースからデータを取得します。 ( ListControl から継承されます。) |
| | RaiseBubbleEvent | イベントのソースおよびその情報をコントロールの親に割り当てます。 ( Control から継承されます。) |
| | RaisePostDataChangedEvent | ポストバックが発生したときに DropDownList コントロールのイベントを発生させます。 |
| | RemovedControl | 子コントロールが Control オブジェクトの Controls コレクションから削除された後に呼び出されます。 ( Control から継承されます。) |
| | Render | 指定された HTML ライタにコントロールを表示します。 ( WebControl から継承されます。) |
| | RenderChildren | クライアントに表示される内容の書き込みを行う、指定された HtmlTextWriter オブジェクトに、サーバー コントロールの子を出力します。 ( Control から継承されます。) |
| | RenderContents | ListControl コントロールの各項目を表示します。 ( ListControl から継承されます。) |
| | RenderControl | オーバーロードされます。 サーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を格納します。 ( Control から継承されます。) |
| | ResolveAdapter | 指定したコントロールを表示するコントロール アダプタを取得します。 ( Control から継承されます。) |
| | SaveControlState | ページがサーバーにポスト バックされた時間以降に発生した、サーバー コントロールの状態の変更を保存します。 ( Control から継承されます。) |
| | SaveViewState | ListControl 派生コントロールおよび格納されている項目の現在のビューステートを保存します。 ( ListControl から継承されます。) |
| | SetDesignModeState | コントロールのデザイン時データを設定します。 ( Control から継承されます。) |
| | SetPostDataSelection | ページがポストされた後、ListItem コントロールの Selected プロパティを設定します。 ( ListControl から継承されます。) |
| | TrackViewState | ListControl 派生コントロールに対するビューステートの変更の追跡と保存を始める開始点にマークを付けます。 ( ListControl から継承されます。) |
| | ValidateDataSource | データ バインド コントロールのバインド先のオブジェクトが処理可能かどうかを確認します。 ( DataBoundControl から継承されます。) |
| | VerifyMultiSelect | オーバーライドされます。 DropDownList コントロールでは複数選択がサポートされていないため、常に HttpException 例外がスローされます。 |
明示的インターフェイスの実装| 名前 | 説明 | |
|---|---|---|
.gif) | System.Web.UI.IPostBackDataHandler.LoadPostData | DropDownList コントロールのポストされたデータを処理します。 |
| | System.Web.UI.IPostBackDataHandler.RaisePostDataChangedEvent | ポストバック時に DropDownList コントロールのイベントを発生させます。 |
参照DropDownList メンバ
ユーザーがドロップダウン リストから単一の項目を選択できるコントロールを表します。
DropDownList データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック プロパティ
(
プロテクト プロパティ
も参照)
プロテクト プロパティパブリック メソッド
(
プロテクト メソッド
も参照)
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | AddAttributesToRender | オーバーライドされます。 指定した HtmlTextWriter オブジェクトに表示する必要のある HTML 属性およびスタイルを追加します。 |
| | AddedControl | 子コントロールが Control オブジェクトの Controls コレクションに追加された後に呼び出されます。 (Control から継承されます。) |
| | AddParsedSubObject | サーバー コントロールに、XML または HTML の要素が解析されたことを通知し、その要素をサーバー コントロールの ControlCollection オブジェクトに追加します。 (Control から継承されます。) |
| | BuildProfileTree | ページのトレースが有効な場合、サーバー コントロールに関する情報を収集し、これを表示するために Trace プロパティに渡します。 (Control から継承されます。) |
| | ClearChildControlState | サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。 (Control から継承されます。) |
| | ClearChildState | サーバー コントロールのすべての子コントロールのビューステート情報およびコントロールの状態情報を削除します。 (Control から継承されます。) |
| | ClearChildViewState | サーバー コントロールのすべての子コントロールのビューステート情報を削除します。 (Control から継承されます。) |
| | ConfirmInitState | データ バインド コントロールの初期化状態を設定します。 (BaseDataBoundControl から継承されます。) |
| | CreateChildControls | ASP.NET ページ フレームワークによって呼び出され、コンポジション ベースの実装を使用するサーバー コントロールに、ポスト バックまたは表示のための準備として、格納する子コントロールを作成するように通知します。 (Control から継承されます。) |
| | CreateControlCollection | オーバーライドされます。 子コントロールを格納するコレクションを作成します。 |
| | CreateControlStyle | WebControl クラスで、すべてのスタイル関連プロパティを実装するために内部的に使用されるスタイル オブジェクトを作成します。このメソッドは、主にコントロールの開発者によって使用されます。 (WebControl から継承されます。) |
| | CreateDataSourceSelectArguments | 引数が未指定の場合に、データ バインド コントロールが使用する既定の DataSourceSelectArguments オブジェクトを作成します。 (DataBoundControl から継承されます。) |
| | DataBind | オーバーロードされます。 呼び出されたサーバー コントロールと、そのすべての子コントロールにデータ ソースを連結します。 (Control から継承されます。) |
| | DataBindChildren | データ ソースをサーバー コントロールの子コントロールにバインドします。 (Control から継承されます。) |
| | EnsureChildControls | サーバー コントロールに子コントロールが含まれているかどうかを確認します。含まれていない場合、子コントロールを作成します。 (Control から継承されます。) |
| | EnsureDataBound | DataSourceID プロパティが設定されていて、データ バインド コントロールにバインディングが必要とマークされている場合に、DataBind メソッドを呼び出します。 (BaseDataBoundControl から継承されます。) |
| | EnsureID | ID が割り当てられていないコントロールの ID を作成します。 (Control から継承されます。) |
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| | FindControl | オーバーロードされます。 指定したサーバー コントロールの現在の名前付けコンテナを検索します。 (Control から継承されます。) |
| | GetData | データ操作を実行するために、データ バインド コントロールが使用する DataSourceView オブジェクトを取得します。 (DataBoundControl から継承されます。) |
| | GetDataSource | データ バインド コントロールが関連付けられている IDataSource インターフェイスを取得します (存在する場合)。 (DataBoundControl から継承されます。) |
| | GetDesignModeState | コントロールのデザイン時データを取得します。 (Control から継承されます。) |
| | HasEvents | コントロールまたは子コントロールに対してイベントが登録されているかどうかを示す値を返します。 (Control から継承されます。) |
| | IsLiteralContent | サーバー コントロールがリテラルな内容だけを保持しているかどうかを決定します。 (Control から継承されます。) |
| | LoadControlState | SaveControlState メソッドによって保存された前回のページ要求からコントロールの状態情報を復元します。 (Control から継承されます。) |
| | LoadPostData | DropDownList コントロールのポストバック データを処理します。 |
| | LoadViewState | 以前に保存した DetailsView コントロールのビューステートを読み込みます。 (ListControl から継承されます。) |
| | MapPathSecure | 仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。 (Control から継承されます。) |
| | MarkAsDataBound | ビューステートのコントロールの状態を、データに正常にバインドされた状態に設定します。 (DataBoundControl から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
| | OnBubbleEvent | サーバー コントロールのイベントをページの UI サーバー コントロールの階層構造に渡すかどうかを決定します。 (Control から継承されます。) |
| | OnDataBinding | DataBinding イベントを発生させます。 (ListControl から継承されます。) |
| | OnDataBound | DataBound イベントを発生させます。 (BaseDataBoundControl から継承されます。) |
| | OnDataPropertyChanged | 基本データ ソース識別プロパティのいずれかが変更された後、データ バインド コントロールをデータにバインドし直します。 (DataBoundControl から継承されます。) |
| | OnDataSourceViewChanged | DataSourceViewChanged イベントを発生させます。 (DataBoundControl から継承されます。) |
| | OnInit | Init イベントを処理します。 (BaseDataBoundControl から継承されます。) |
| | OnLoad | Control.Load イベントを処理します。 (DataBoundControl から継承されます。) |
| | OnPagePreLoad | コントロールが読み込まれる前に、データ バインド コントロールの初期化状態を設定します。 (DataBoundControl から継承されます。) |
| | OnPreRender | PreRender イベントを発生させます。 (ListControl から継承されます。) |
| | OnSelectedIndexChanged | SelectedIndexChanged イベントを発生させます。この機能により、イベントのカスタム ハンドラを作成できます。 (ListControl から継承されます。) |
| | OnTextChanged | TextChanged イベントを発生させます。 (ListControl から継承されます。) |
| | OnUnload | Unload イベントを発生させます。 (Control から継承されます。) |
| | OpenFile | ファイルの読み込みで使用される Stream を取得します。 (Control から継承されます。) |
| | PerformDataBinding | 指定したデータ ソースを、ListControl クラスから派生したコントロールにバインドします。 (ListControl から継承されます。) |
| | PerformSelect | 関連するデータ ソースからデータを取得します。 (ListControl から継承されます。) |
| | RaiseBubbleEvent | イベントのソースおよびその情報をコントロールの親に割り当てます。 (Control から継承されます。) |
| | RaisePostDataChangedEvent | ポストバックが発生したときに DropDownList コントロールのイベントを発生させます。 |
| | RemovedControl | 子コントロールが Control オブジェクトの Controls コレクションから削除された後に呼び出されます。 (Control から継承されます。) |
| | Render | 指定された HTML ライタにコントロールを表示します。 (WebControl から継承されます。) |
| | RenderChildren | クライアントに表示される内容の書き込みを行う、指定された HtmlTextWriter オブジェクトに、サーバー コントロールの子を出力します。 (Control から継承されます。) |
| | RenderContents | ListControl コントロールの各項目を表示します。 (ListControl から継承されます。) |
| | RenderControl | オーバーロードされます。 サーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を格納します。 (Control から継承されます。) |
| | ResolveAdapter | 指定したコントロールを表示するコントロール アダプタを取得します。 (Control から継承されます。) |
| | SaveControlState | ページがサーバーにポスト バックされた時間以降に発生した、サーバー コントロールの状態の変更を保存します。 (Control から継承されます。) |
| | SaveViewState | ListControl 派生コントロールおよび格納されている項目の現在のビューステートを保存します。 (ListControl から継承されます。) |
| | SetDesignModeState | コントロールのデザイン時データを設定します。 (Control から継承されます。) |
| | SetPostDataSelection | ページがポストされた後、ListItem コントロールの Selected プロパティを設定します。 (ListControl から継承されます。) |
| | TrackViewState | ListControl 派生コントロールに対するビューステートの変更の追跡と保存を始める開始点にマークを付けます。 (ListControl から継承されます。) |
| | ValidateDataSource | データ バインド コントロールのバインド先のオブジェクトが処理可能かどうかを確認します。 (DataBoundControl から継承されます。) |
| | VerifyMultiSelect | オーバーライドされます。 DropDownList コントロールでは複数選択がサポートされていないため、常に HttpException 例外がスローされます。 |
パブリック イベント| 名前 | 説明 | |
|---|---|---|
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
| | DataBound | サーバー コントロールがデータ ソースにバインドした後に発生します。(BaseDataBoundControl から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
| | SelectedIndexChanged | リスト コントロール内の選択項目がサーバーへのポスト間で変更された場合に発生します。(ListControl から継承されます。) |
| | TextChanged | Text プロパティと SelectedValue プロパティが変更された場合に発生します。(ListControl から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
明示的インターフェイスの実装| 名前 | 説明 | |
|---|---|---|
| | System.Web.UI.IPostBackDataHandler.LoadPostData | DropDownList コントロールのポストされたデータを処理します。 |
| | System.Web.UI.IPostBackDataHandler.RaisePostDataChangedEvent | ポストバック時に DropDownList コントロールのイベントを発生させます。 |
参照
ドロップダウンリスト
(drop down-list から転送)
出典: フリー百科事典『ウィキペディア（Wikipedia）』 (2022/09/26 08:40 UTC 版)
ドロップダウンリスト（英: drop-down list）はGUIにおけるユーザインタフェースコントロール要素の1つ。リストボックスと似ており、ユーザーが一覧から1つの値を選択することを可能にする。ユーザーが新たに値を選択すると不活性状態に戻り、選択された値だけを表示する。
一般的なWindowsのデザインでは、単一の値を表示するボックスの下にリストボックスを配置するが、古いユーザインタフェース（例えばMotif）や macOS のAquaでは、選択されている値を中心として上下にリストボックスが展開する（同じ値を選択するときマウスを動かさなくてもよいという利点がある）。これを「ポップアップリスト」や "choice" あるいは "chooser" とも呼んだが、現在では「ドロップダウンリスト」という名称が一般に使われている。
ドロップダウンリストはコンボボックスとは異なり、ユーザーは値を編集できない。ウェブブラウザのアドレス入力部分はドロップダウンリストではなく、コンボボックスの一例である。
ドロップダウンリストはリストボックスやタブに比較すると、一見して1つのオプションだけが表示され、そこにオプションの一覧がコントロールとして存在すると気づかない場合があるという欠点がある。逆に、ラジオボタン付きリストなどに比べると、機能の表示に必要なスペースが非常に小さいという利点がある。
このようなコントロールをMacintoshなどでは「ポップアップメニュー」とも呼ぶが、ポップアップメニューという呼称は他のGUIシステムではコンテキストメニューを意味する。Macintosh には「プルダウンメニュー」又は「コマンドポップダウンメニュー」という呼称もある。これらの違いは、ポップアップメニューが不活性のときは直前に選択したアイテムが表示されるのに対して、プルダウンメニューでは固定のタイトル（メニュー名）が表示されている。したがって、これらは用途が異なり、ポップアップメニューがオプション一覧からオプションを選択するのに使われ、プルダウンメニューは様々なオプションのあるコマンド実行に使われる。この種のリストの対話的なデモがこちら[1]にある。
関連項目
「Drop-down list」の例文・使い方・用例・文例
- drop down-listのページへのリンク
