DropDownList クラス

定義

ユーザーがドロップダウン リストから単一の項目を選択できるコントロールを表します。Represents a control that allows the user to select a single item from a drop-down list.

public ref class DropDownList : System::Web::UI::WebControls::ListControl, System::Web::UI::IPostBackDataHandler
[System.Web.UI.ValidationProperty("SelectedItem")]
public class DropDownList : System.Web.UI.WebControls.ListControl, System.Web.UI.IPostBackDataHandler
type DropDownList = class
    inherit ListControl
    interface IPostBackDataHandler
Public Class DropDownList
Inherits ListControl
Implements IPostBackDataHandler
継承
属性
実装

このトピックには、ソースコードが含まれた Visual Studio Web サイトプロジェクトが用意されています。をダウンロードします。A Visual Studio Web site project with source code is available to accompany this topic: Download.

次のコード例は、4つのDropDownList項目を含むコントロールを作成する方法を示しています。The following code example demonstrates how to create a DropDownList control that contains four items.

<%@ 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" >
   <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>
  
<head runat="server">
    <title> DropDownList Example </title>
</head>
<body>

   <form id="form1" 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>
  
      </table>
  
   </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" >
   <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>
  
<head runat="server">
    <title> DropDownList Example </title>
</head>
<body>

   <form id="form1" 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>
         
      </table>   
  
   </form>

</body>
</html>
 

データバインディングでコントロールをDropDownList作成する方法を次のコード例に示します。The following code example demonstrates how to create a DropDownList control though data binding.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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" >
   <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>
  
<head runat="server">
    <title> DropDownList Data Binding Example </title>
</head>
<body>

   <form id="form1" 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>
         
      </table>   
  
   </form>

</body>
</html>
 
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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" >
   <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>
  
<head runat="server">
    <title> DropDownList Data Binding Example </title>
</head>
<body>

   <form id="form1" 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>
         
      </table>   
  
   </form>

</body>
</html>
 

注釈

このトピックの内容:In this topic:

はじめにIntroduction

コントロールをDropDownList使用して、単一選択のドロップダウンリストコントロールを作成します。Use the DropDownList control to create a single-selection drop-down list control. BorderColorDropDownList 、およびBorderWidthの各プロパティを設定することによって、コントロールの外観を制御できます。 BorderStyleYou can control the appearance of the DropDownList control by setting the BorderColor, BorderStyle, and BorderWidth properties.

DropDownListコントロールに表示する項目を指定するには、 DropDownListコントロールの開始タグListItemと終了タグの間の各エントリにオブジェクトを配置します。To specify the items that you want to appear in the DropDownList control, place a ListItem object for each entry between the opening and closing tags of the DropDownList control.

コントロールDropDownListは、データバインディングもサポートしています。The DropDownList control also supports data binding. コントロールをデータソースにバインドするには、コントロールに表示する項目を格納System.Collections.ArrayListするデータソース (オブジェクトなど) を作成します。To bind the control to a data source, create a data source, such as a System.Collections.ArrayList object, that contains the items to display in the control. 次に、 Control.DataBindメソッドを使用して、データソースをDropDownListコントロールにバインドします。Then, use the Control.DataBind method to bind the data source to the DropDownList control.

コントロールからユーザーが選択した項目のインデックスをプログラムで判断するには、 SelectedIndexプロパティを使用します。 DropDownListUse the SelectedIndex property to programmatically determine the index of the item selected by the user from the DropDownList control. その後、インデックスを使用して、コントロールのItemsコレクションから選択した項目を取得できます。The index can then be used to retrieve the selected item from the Items collection of the control.

ユーザー補助Accessibility

ユーザー補助の標準に準拠するマークアップを生成するように、このコントロールを構成する方法については、次を参照してくださいVisual Studio と ASP.NET のユーザー補助機能ASP.NET コントロールやユーザー補助機能For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio and ASP.NET and ASP.NET Controls and Accessibility.

宣言型の構文Declarative Syntax

<asp:DropDownList  
    AccessKey="string"  
    AppendDataBoundItems="True|False"  
    AutoPostBack="True|False"  
    BackColor="color name|#dddddd"  
    BorderColor="color name|#dddddd"  
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|  
        Inset|Outset"  
    BorderWidth="size"  
    CausesValidation="True|False"  
    CssClass="string"  
    DataMember="string"  
    DataSource="string"  
    DataSourceID="string"  
    DataTextField="string"  
    DataTextFormatString="string"  
    DataValueField="string"  
    Enabled="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    Font-Bold="True|False"  
    Font-Italic="True|False"  
    Font-Names="string"  
    Font-Overline="True|False"  
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|  
        Large|X-Large|XX-Large"  
    Font-Strikeout="True|False"  
    Font-Underline="True|False"  
    ForeColor="color name|#dddddd"  
    Height="size"  
    ID="string"  
    OnDataBinding="DataBinding event handler"  
    OnDataBound="DataBound event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnSelectedIndexChanged="SelectedIndexChanged event handler"  
    OnTextChanged="TextChanged event handler"  
    OnUnload="Unload event handler"  
    runat="server"  
    SelectedIndex="integer"  
    SelectedValue="string"  
    SkinID="string"  
    Style="string"  
    TabIndex="integer"  
    ToolTip="string"  
    ValidationGroup="string"  
    Visible="True|False"  
    Width="size"  
>  
            <asp:ListItem  
                Enabled="True|False"  
                Selected="True|False"  
                Text="string"  
                Value="string"  
            />  
</asp:DropDownList>  

コンストラクター

DropDownList()

DropDownList クラスの新しいインスタンスを初期化します。Initializes a new instance of the DropDownList class.

プロパティ

AccessKey

Web サーバー コントロールにすばやく移動できるアクセス キーを取得または設定します。Gets or sets the access key that allows you to quickly navigate to the Web server control.

(継承元 WebControl)
Adapter

コントロール用のブラウザー固有のアダプターを取得します。Gets the browser-specific adapter for the control.

(継承元 Control)
AppendDataBoundItems

データ バインディングの前にリスト項目が消去されるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether list items are cleared before data binding.

(継承元 ListControl)
AppRelativeTemplateSourceDirectory

このコントロールが含まれている Page オブジェクトまたは UserControl オブジェクトのアプリケーション相対の仮想ディレクトリを取得または設定します。Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(継承元 Control)
Attributes

コントロールのプロパティに対応しない任意の属性 (表示専用) のコレクションを取得します。Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(継承元 WebControl)
AutoPostBack

リストの選択を変更したときに、サーバーへのポストバックが自動的に発生するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the list selection.

(継承元 ListControl)
BackColor

Web サーバー コントロールの背景色を取得または設定します。Gets or sets the background color of the Web server control.

(継承元 WebControl)
BindingContainer

このコントロールのデータ バインディングを格納しているコントロールを取得します。Gets the control that contains this control's data binding.

(継承元 Control)
BorderColor

コントロールの境界線の色を取得または設定します。Gets or sets the border color of the control.

BorderStyle

コントロールの境界線スタイルを取得または設定します。Gets or sets the border style of the control.

BorderWidth

コントロールの境界線の幅を取得または設定します。Gets or sets the border width for the control.

CausesValidation

ListControl クラスから派生したコントロールがクリックされたときに検証を実行するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether validation is performed when a control that is derived from the ListControl class is clicked.

(継承元 ListControl)
ChildControlsCreated

サーバー コントロールの子コントロールが作成されたかどうかを示す値を取得します。Gets a value that indicates whether the server control's child controls have been created.

(継承元 Control)
ClientID

ASP.NET によって生成される HTML マークアップのコントロール ID を取得します。Gets the control ID for HTML markup that is generated by ASP.NET.

(継承元 Control)
ClientIDMode

ClientID プロパティの値を生成するために使用されるアルゴリズムを取得または設定します。Gets or sets the algorithm that is used to generate the value of the ClientID property.

(継承元 Control)
ClientIDSeparator

ClientID プロパティで使用される区切り記号を表す文字値を取得します。Gets a character value representing the separator character used in the ClientID property.

(継承元 Control)
Context

現在の Web 要求に対するサーバー コントロールに関連付けられている HttpContext オブジェクトを取得します。Gets the HttpContext object associated with the server control for the current Web request.

(継承元 Control)
Controls

UI 階層内の指定されたサーバー コントロールの子コントロールを表す ControlCollection オブジェクトを取得します。Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(継承元 Control)
ControlStyle

Web サーバー コントロールのスタイルを取得します。Gets the style of the Web server control. このプロパティは、主にコントロールの開発者によって使用されます。This property is used primarily by control developers.

(継承元 WebControl)
ControlStyleCreated

Style オブジェクトが ControlStyle プロパティに対して作成されたかどうかを示す値を取得します。Gets a value indicating whether a Style object has been created for the ControlStyle property. このプロパティは、主にコントロールの開発者によって使用されます。This property is primarily used by control developers.

(継承元 WebControl)
CssClass

クライアントで Web サーバー コントロールによって表示されるカスケード スタイル シート (CSS: Cascading Style Sheet) クラスを取得または設定します。Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(継承元 WebControl)
DataItemContainer

名前付けコンテナーが IDataItemContainer を実装している場合、名前付けコンテナーへの参照を取得します。Gets a reference to the naming container if the naming container implements IDataItemContainer.

(継承元 Control)
DataKeysContainer

名前付けコンテナーが IDataKeysControl を実装している場合、名前付けコンテナーへの参照を取得します。Gets a reference to the naming container if the naming container implements IDataKeysControl.

(継承元 Control)
DataMember

コントロールに連結する DataSource の特定のテーブルを取得または設定します。Gets or sets the specific table in the DataSource to bind to the control.

(継承元 ListControl)
DataSource

リスト コントロールの項目を生成するデータ ソースを取得または設定します。Gets or sets the data source that populates the items of the list control.

(継承元 ListControl)
DataTextField

リスト項目のテキストの内容を提供するために、データ ソースのフィールドを取得または設定します。Gets or sets the field of the data source that provides the text content of the list items.

(継承元 ListControl)
DataTextFormatString

リスト コントロールに連結されたデータの表示方法を制御するために使用する、書式指定文字列を取得または設定します。Gets or sets the formatting string used to control how data bound to the list control is displayed.

(継承元 ListControl)
DataValueField

各リスト項目の値を提供するデータ ソースのフィールドを取得または設定します。Gets or sets the field of the data source that provides the value of each list item.

(継承元 ListControl)
DesignMode

コントロールがデザイン サーフェイスで使用されているかどうかを示す値を取得します。Gets a value indicating whether a control is being used on a design surface.

(継承元 Control)
Enabled

Web サーバー コントロールを有効にするかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the Web server control is enabled.

(継承元 WebControl)
EnableTheming

テーマがこのコントロールに適用されるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether themes apply to this control.

(継承元 WebControl)
EnableViewState

要求元クライアントに対して、サーバー コントロールがそのビュー状態と、そこに含まれる任意の子のコントロールのビュー状態を保持するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(継承元 Control)
Events

コントロールのイベント ハンドラー デリゲートのリストを取得します。Gets a list of event handler delegates for the control. このプロパティは読み取り専用です。This property is read-only.

(継承元 Control)
Font

Web サーバー コントロールに関連付けられたフォント プロパティを取得します。Gets the font properties associated with the Web server control.

(継承元 WebControl)
ForeColor

Web サーバー コントロールの前景色 (通常はテキストの色) を取得または設定します。Gets or sets the foreground color (typically the color of the text) of the Web server control.

(継承元 WebControl)
HasAttributes

コントロールに属性セットがあるかどうかを示す値を取得します。Gets a value indicating whether the control has attributes set.

(継承元 WebControl)
HasChildViewState

現在のサーバー コントロールの子コントロールが、保存されたビューステートの設定を持っているかどうかを示す値を取得します。Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(継承元 Control)
Height

Web サーバー コントロールの高さを取得または設定します。Gets or sets the height of the Web server control.

(継承元 WebControl)
ID

サーバー コントロールに割り当てられたプログラム ID を取得または設定します。Gets or sets the programmatic identifier assigned to the server control.

(継承元 Control)
IdSeparator

コントロール ID を区別するために使用する文字を取得します。Gets the character used to separate control identifiers.

(継承元 Control)
IsChildControlStateCleared

このコントロールに含まれているコントロールに、コントロールの状態が設定されているかどうかを示す値を取得します。Gets a value indicating whether controls contained within this control have control state.

(継承元 Control)
IsEnabled

コントロールが有効かどうかを示す値を取得します。Gets a value indicating whether the control is enabled.

(継承元 WebControl)
IsTrackingViewState

サーバー コントロールがビューステートの変更を保存しているかどうかを示す値を取得します。Gets a value that indicates whether the server control is saving changes to its view state.

(継承元 Control)
IsViewStateEnabled

このコントロールでビューステートが有効かどうかを示す値を取得します。Gets a value indicating whether view state is enabled for this control.

(継承元 Control)
Items

リスト コントロールの項目のコレクションを取得します。Gets the collection of items in the list control.

(継承元 ListControl)
LoadViewStateByID

コントロールがインデックスではなく ID によりビューステートの読み込みを行うかどうかを示す値を取得します。Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(継承元 Control)
NamingContainer

同じ ID プロパティ値を持つ複数のサーバー コントロールを区別するための一意の名前空間を作成する、サーバー コントロールの名前付けコンテナーへの参照を取得します。Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(継承元 Control)
Page

サーバー コントロールを含んでいる Page インスタンスへの参照を取得します。Gets a reference to the Page instance that contains the server control.

(継承元 Control)
Parent

ページ コントロールの階層構造における、サーバー コントロールの親コントロールへの参照を取得します。Gets a reference to the server control's parent control in the page control hierarchy.

(継承元 Control)
RenderingCompatibility

レンダリングされる HTML と互換性がある ASP.NET のバージョンを表す値を取得します。Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(継承元 Control)
SelectedIndex

DropDownList コントロール内の選択された項目のインデックスを取得または設定します。Gets or sets the index of the selected item in the DropDownList control.

SelectedItem

リスト コントロールで最小のインデックスを持つ選択された項目を取得します。Gets the selected item with the lowest index in the list control.

(継承元 ListControl)
SelectedValue

リスト コントロール内の選択されている項目の値を取得します。または、指定した値が含まれるリスト コントロール内の項目を選択します。Gets the value of the selected item in the list control, or selects the item in the list control that contains the specified value.

(継承元 ListControl)
Site

デザイン サーフェイスに現在のコントロールを表示するときに、このコントロールをホストするコンテナーに関する情報を取得します。Gets information about the container that hosts the current control when rendered on a design surface.

(継承元 Control)
SkinID

コントロールに適用するスキンを取得または設定します。Gets or sets the skin to apply to the control.

(継承元 WebControl)
Style

Web サーバー コントロールの外側のタグにスタイル属性として表示されるテキスト属性のコレクションを取得します。Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(継承元 WebControl)
SupportsDisabledAttribute

コントロールの IsEnabled プロパティが disabled の場合、レンダリングされた HTML 要素の false 属性を "無効" に設定するかどうかを示す値を取得します。Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

TabIndex

Web サーバー コントロールのタブ インデックスを取得または設定します。Gets or sets the tab index of the Web server control.

(継承元 WebControl)
TagKey

ListControl コントロールの HtmlTextWriterTag 値を取得します。Gets the HtmlTextWriterTag value for the ListControl control.

(継承元 ListControl)
TagName

コントロール タグの名前を取得します。Gets the name of the control tag. このプロパティは、主にコントロールの開発者によって使用されます。This property is used primarily by control developers.

(継承元 WebControl)
TemplateControl

このコントロールを格納しているテンプレートへの参照を取得または設定します。Gets or sets a reference to the template that contains this control.

(継承元 Control)
TemplateSourceDirectory

現在のサーバー コントロールを格納している Page または UserControl の仮想ディレクトリを取得します。Gets the virtual directory of the Page or UserControl that contains the current server control.

(継承元 Control)
Text

ListControl コントロールの SelectedValue プロパティを取得または設定します。Gets or sets the SelectedValue property of the ListControl control.

(継承元 ListControl)
ToolTip

マウス ポインターがコントロール上に置かれているときに表示されるヒント テキストを取得または設定します。Gets or sets the ToolTip text displayed when the mouse pointer rests over the control.

UniqueID

階層構造で修飾されたサーバー コントロールの一意の ID を取得します。Gets the unique, hierarchically qualified identifier for the server control.

(継承元 Control)
ValidateRequestMode

ブラウザーからのクライアント入力の安全性をコントロールで調べるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(継承元 Control)
ValidationGroup

サーバーへのポストバック時に、ListControl クラスから派生したコントロールによって発生する検証の対象となるコントロールのグループを取得または設定します。Gets or sets the group of controls for which the control that is derived from the ListControl class causes validation when it posts back to the server.

(継承元 ListControl)
ViewState

同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(継承元 Control)
ViewStateIgnoresCase

StateBag オブジェクトが大文字小文字を区別しないかどうかを示す値を取得します。Gets a value that indicates whether the StateBag object is case-insensitive.

(継承元 Control)
ViewStateMode

このコントロールのビューステート モードを取得または設定します。Gets or sets the view-state mode of this control.

(継承元 Control)
Visible

サーバー コントロールがページ上の UI としてレンダリングされているかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(継承元 Control)
Width

Web サーバー コントロールの幅を取得または設定します。Gets or sets the width of the Web server control.

(継承元 WebControl)

メソッド

AddAttributesToRender(HtmlTextWriter)

指定した HtmlTextWriter オブジェクトに表示する必要のある HTML 属性およびスタイルを追加します。Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter object.

AddedControl(Control, Int32)

子コントロールが Control オブジェクトの Controls コレクションに追加された後に呼び出されます。Called after a child control is added to the Controls collection of the Control object.

(継承元 Control)
AddParsedSubObject(Object)

XML または HTML のいずれかの要素が解析されたことをサーバー コントロールに通知し、サーバー コントロールの ControlCollection オブジェクトに要素を追加します。Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(継承元 Control)
ApplyStyle(Style)

指定したスタイルの空白以外の要素を Web コントロールにコピーして、コントロールの既存のスタイル要素を上書きします。Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. このメソッドは、主にコントロールの開発者によって使用されます。This method is primarily used by control developers.

(継承元 WebControl)
ApplyStyleSheetSkin(Page)

ページのスタイル シートに定義されたスタイル プロパティをコントロールに適用します。Applies the style properties defined in the page style sheet to the control.

(継承元 Control)
BeginRenderTracing(TextWriter, Object)

レンダリング データのデザイン時のトレースを開始します。Begins design-time tracing of rendering data.

(継承元 Control)
BuildProfileTree(String, Boolean)

ページのトレースが有効な場合、サーバー コントロールに関する情報を収集し、これを表示するために Trace プロパティに渡します。Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(継承元 Control)
ClearCachedClientID()

キャッシュされた ClientID 値を null に設定します。Sets the cached ClientID value to null.

(継承元 Control)
ClearChildControlState()

サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。Deletes the control-state information for the server control's child controls.

(継承元 Control)
ClearChildState()

サーバー コントロールのすべての子コントロールのビューステート情報およびコントロールの状態情報を削除します。Deletes the view-state and control-state information for all the server control's child controls.

(継承元 Control)
ClearChildViewState()

サーバー コントロールのすべての子コントロールのビューステート情報を削除します。Deletes the view-state information for all the server control's child controls.

(継承元 Control)
ClearEffectiveClientIDMode()

現在のコントロール インスタンスおよびすべての子コントロールの ClientIDMode プロパティを Inherit に設定します。Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(継承元 Control)
ClearSelection()

リストの選択を解除して、すべての項目の Selected プロパティを false に設定します。Clears out the list selection and sets the Selected property of all items to false.

(継承元 ListControl)
CopyBaseAttributes(WebControl)

指定した Web サーバー コントロールから、Style オブジェクトでカプセル化されていないプロパティをこのメソッドの呼び出し元の Web サーバー コントロールにコピーします。Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. このメソッドは、主にコントロールの開発者によって使用されます。This method is used primarily by control developers.

(継承元 WebControl)
CreateChildControls()

ASP.NET ページ フレームワークによって呼び出され、ポストバックまたはレンダリングの準備として、合成ベースの実装を使うサーバー コントロールに対し、それらのコントロールに含まれる子コントロールを作成するように通知します。Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(継承元 Control)
CreateControlCollection()

子コントロールを格納するコレクションを作成します。Creates a collection to store child controls.

CreateControlStyle()

WebControl クラスで、すべてのスタイル関連プロパティを実装するために内部的に使用されるスタイル オブジェクトを作成します。Creates the style object that is used internally by the WebControl class to implement all style related properties. このメソッドは、主にコントロールの開発者によって使用されます。This method is used primarily by control developers.

(継承元 WebControl)
DataBind()

呼び出されたサーバー コントロールとそのすべての子コントロールにデータ ソースをバインドします。Binds a data source to the invoked server control and all its child controls.

(継承元 Control)
DataBind(Boolean)

DataBinding イベントを発生させるオプションを指定して、呼び出されたサーバー コントロールとそのすべての子コントロールにデータ ソースをバインドします。Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(継承元 Control)
DataBindChildren()

データ ソースをサーバー コントロールの子コントロールにバインドします。Binds a data source to the server control's child controls.

(継承元 Control)
Dispose()

サーバー コントロールが、メモリから解放される前に最終的なクリーンアップを実行できるようにします。Enables a server control to perform final clean up before it is released from memory.

(継承元 Control)
EndRenderTracing(TextWriter, Object)

レンダリング データのデザイン時のトレースを終了します。Ends design-time tracing of rendering data.

(継承元 Control)
EnsureChildControls()

サーバー コントロールに子コントロールが含まれているかどうかを確認します。Determines whether the server control contains child controls. 含まれていない場合、子コントロールを作成します。If it does not, it creates child controls.

(継承元 Control)
EnsureID()

ID が割り当てられていないコントロールの ID を作成します。Creates an identifier for controls that do not have an identifier assigned.

(継承元 Control)
Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
FindControl(String)

指定した id パラメーターを使用して、サーバー コントロールの現在の名前付けコンテナーを検索します。Searches the current naming container for a server control with the specified id parameter.

(継承元 Control)
FindControl(String, Int32)

指定した id および検索に役立つ pathOffset パラメーターに指定された整数を使用して、サーバー コントロールの現在の名前付けコンテナーを検索します。Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. この形式の FindControl メソッドはオーバーライドしないでください。You should not override this version of the FindControl method.

(継承元 Control)
Focus()

コントロールに入力フォーカスを設定します。Sets input focus to a control.

(継承元 Control)
GetDesignModeState()

コントロールのデザイン時データを取得します。Gets design-time data for a control.

(継承元 Control)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetRouteUrl(Object)

ルート パラメーターのセットに対応する URL を取得します。Gets the URL that corresponds to a set of route parameters.

(継承元 Control)
GetRouteUrl(RouteValueDictionary)

ルート パラメーターのセットに対応する URL を取得します。Gets the URL that corresponds to a set of route parameters.

(継承元 Control)
GetRouteUrl(String, Object)

ルート パラメーターのセットおよびルート名に対応する URL を取得します。Gets the URL that corresponds to a set of route parameters and a route name.

(継承元 Control)
GetRouteUrl(String, RouteValueDictionary)

ルート パラメーターのセットおよびルート名に対応する URL を取得します。Gets the URL that corresponds to a set of route parameters and a route name.

(継承元 Control)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
GetUniqueIDRelativeTo(Control)

指定されたコントロールの UniqueID プロパティのプレフィックス部分を返します。Returns the prefixed portion of the UniqueID property of the specified control.

(継承元 Control)
HasControls()

サーバー コントロールに子コントロールが含まれているかどうかを確認します。Determines if the server control contains any child controls.

(継承元 Control)
HasEvents()

コントロールまたは子コントロールに対してイベントが登録されているかどうかを示す値を返します。Returns a value indicating whether events are registered for the control or any child controls.

(継承元 Control)
IsLiteralContent()

サーバー コントロールがリテラルな内容だけを保持しているかどうかを決定します。Determines if the server control holds only literal content.

(継承元 Control)
LoadControlState(Object)

SaveControlState() メソッドによって保存された前回のページ要求からコントロールの状態情報を復元します。Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(継承元 Control)
LoadPostData(String, NameValueCollection)

DropDownList コントロールのポストバック データを処理します。Processes postback data for the DropDownList control.

LoadViewState(Object)

以前に保存した DetailsView コントロールのビュー ステートを読み込みます。Loads the previously saved view state of the DetailsView control.

(継承元 ListControl)
MapPathSecure(String)

仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(継承元 Control)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MergeStyle(Style)

指定したスタイルの空白以外の要素を Web コントロールにコピーしますが、コントロールの既存のスタイル要素は上書きしません。Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. このメソッドは、主にコントロールの開発者によって使用されます。This method is used primarily by control developers.

(継承元 WebControl)
OnBubbleEvent(Object, EventArgs)

サーバー コントロールのイベントをページの UI サーバー コントロールの階層構造に渡すかどうかを決定します。Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(継承元 Control)
OnDataBinding(EventArgs)

DataBinding イベントを発生させます。Raises the DataBinding event.

(継承元 ListControl)
OnInit(EventArgs)

Init イベントを発生させます。Raises the Init event.

(継承元 Control)
OnLoad(EventArgs)

Load イベントを発生させます。Raises the Load event.

(継承元 Control)
OnPreRender(EventArgs)

PreRender イベントを発生させます。Raises the PreRender event.

(継承元 ListControl)
OnSelectedIndexChanged(EventArgs)

SelectedIndexChanged イベントを発生させます。Raises the SelectedIndexChanged event. これにより、イベントのカスタム ハンドラーを作成できます。This allows you to provide a custom handler for the event.

(継承元 ListControl)
OnTextChanged(EventArgs)

TextChanged イベントを発生させます。Raises the TextChanged event.

(継承元 ListControl)
OnUnload(EventArgs)

Unload イベントを発生させます。Raises the Unload event.

(継承元 Control)
OpenFile(String)

ファイルの読み込みで使用される Stream を取得します。Gets a Stream used to read a file.

(継承元 Control)
PerformDataBinding(IEnumerable)

指定したデータ ソースを、ListControl クラスから派生したコントロールにバインドします。Binds the specified data source to the control that is derived from the ListControl class.

(継承元 ListControl)
PerformSelect()

関連するデータ ソースからデータを取得します。Retrieves data from the associated data source.

(継承元 ListControl)
RaiseBubbleEvent(Object, EventArgs)

イベントのソースおよびその情報をコントロールの親に割り当てます。Assigns any sources of the event and its information to the control's parent.

(継承元 Control)
RaisePostDataChangedEvent()

ポストバックが発生したときに DropDownList コントロールのイベントを発生させます。Raises events for the DropDownList control when postback occurs.

RemovedControl(Control)

Control オブジェクトの Controls コレクションから子コントロールが削除された後に呼び出されます。Called after a child control is removed from the Controls collection of the Control object.

(継承元 Control)
Render(HtmlTextWriter)

指定された HTML ライターにコントロールを表示します。Renders the control to the specified HTML writer.

(継承元 WebControl)
RenderBeginTag(HtmlTextWriter)

コントロールの HTML 開始タグを指定したライターに表示します。Renders the HTML opening tag of the control to the specified writer. このメソッドは、主にコントロールの開発者によって使用されます。This method is used primarily by control developers.

(継承元 WebControl)
RenderChildren(HtmlTextWriter)

クライアントに表示される内容の書き込みを行う、指定された HtmlTextWriter オブジェクトに、サーバー コントロールの子を出力します。Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(継承元 Control)
RenderContents(HtmlTextWriter)

コントロールの内容を指定したライターに出力します。Renders the contents of the control to the specified writer.

RenderControl(HtmlTextWriter)

指定の HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を保存します。Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(継承元 Control)
RenderControl(HtmlTextWriter, ControlAdapter)

指定した ControlAdapter オブジェクトを使用して、指定した HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力します。Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(継承元 Control)
RenderEndTag(HtmlTextWriter)

コントロールの HTML 終了タグを指定したライターに表示します。Renders the HTML closing tag of the control into the specified writer. このメソッドは、主にコントロールの開発者によって使用されます。This method is used primarily by control developers.

(継承元 WebControl)
ResolveAdapter()

指定したコントロールを表示するコントロール アダプターを取得します。Gets the control adapter responsible for rendering the specified control.

(継承元 Control)
ResolveClientUrl(String)

ブラウザーで使用できる URL を取得します。Gets a URL that can be used by the browser.

(継承元 Control)
ResolveUrl(String)

要求側クライアントで使用できる URL に変換します。Converts a URL into one that is usable on the requesting client.

(継承元 Control)
SaveControlState()

ページがサーバーにポスト バックされた時間以降に発生したすべてのサーバー コントロール状態の変化を保存します。Saves any server control state changes that have occurred since the time the page was posted back to the server.

(継承元 Control)
SaveViewState()

ListControl 派生コントロールおよび格納されている項目の現在のビューステートを保存します。Saves the current view state of the ListControl -derived control and the items it contains.

(継承元 ListControl)
SetDesignModeState(IDictionary)

コントロールのデザイン時データを設定します。Sets design-time data for a control.

(継承元 Control)
SetPostDataSelection(Int32)

ページがポストされた後、Selected コントロールの ListItem プロパティを設定します。Sets the Selected property of a ListItem control after a page is posted.

(継承元 ListControl)
SetRenderMethodDelegate(RenderMethod)

サーバー コントロールとその内容を親コントロールに表示するイベント ハンドラー デリゲートを割り当てます。Assigns an event handler delegate to render the server control and its content into its parent control.

(継承元 Control)
SetTraceData(Object, Object)

トレース データ キーとトレース データ値を使用して、レンダリング データのデザイン時トレースのトレース データを設定します。Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(継承元 Control)
SetTraceData(Object, Object, Object)

トレースされたオブジェクト、トレース データ キー、およびトレース データ値を使用して、レンダリング データのデザイン時トレースのトレース データを設定します。Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(継承元 Control)
ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)
TrackViewState()

ListControl 派生コントロールに対するビューステートの変更の追跡と保存を始める開始点にマークを付けます。Marks the starting point to begin tracking and saving view-state changes to a ListControl -derived control.

(継承元 ListControl)
VerifyMultiSelect()

HttpException コントロールでは複数選択がサポートされていないため、常に DropDownList 例外がスローされます。Always throws an HttpException exception because multiple selection is not supported for the DropDownList control.

イベント

DataBinding

サーバー コントロールがデータ ソースに連結すると発生します。Occurs when the server control binds to a data source.

(継承元 Control)
Disposed

サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(継承元 Control)
Init

サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。Occurs when the server control is initialized, which is the first step in its lifecycle.

(継承元 Control)
Load

サーバー コントロールが Page オブジェクトに読み込まれると発生します。Occurs when the server control is loaded into the Page object.

(継承元 Control)
PreRender

Control オブジェクトの読み込み後、表示を開始する前に発生します。Occurs after the Control object is loaded but prior to rendering.

(継承元 Control)
SelectedIndexChanged

リスト コントロール内の選択項目がサーバーへのポスト間で変更された場合に発生します。Occurs when the selection from the list control changes between posts to the server.

(継承元 ListControl)
TextChanged

Text プロパティと SelectedValue プロパティが変更された場合に発生します。Occurs when the Text and SelectedValue properties change.

(継承元 ListControl)
Unload

サーバー コントロールがメモリからアンロードされると発生します。Occurs when the server control is unloaded from memory.

(継承元 Control)

明示的なインターフェイスの実装

IAttributeAccessor.GetAttribute(String)

指定された名前の Web コントロールの属性を取得します。Gets an attribute of the Web control with the specified name.

(継承元 WebControl)
IAttributeAccessor.SetAttribute(String, String)

Web コントロールの属性を指定された名前と値に設定します。Sets an attribute of the Web control to the specified name and value.

(継承元 WebControl)
IControlBuilderAccessor.ControlBuilder

このメンバーの詳細については、「ControlBuilder」をご覧ください。For a description of this member, see ControlBuilder.

(継承元 Control)
IControlDesignerAccessor.GetDesignModeState()

このメンバーの詳細については、「GetDesignModeState()」をご覧ください。For a description of this member, see GetDesignModeState().

(継承元 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

このメンバーの詳細については、「SetDesignModeState(IDictionary)」をご覧ください。For a description of this member, see SetDesignModeState(IDictionary).

(継承元 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

このメンバーの詳細については、「SetOwnerControl(Control)」をご覧ください。For a description of this member, see SetOwnerControl(Control).

(継承元 Control)
IControlDesignerAccessor.UserData

このメンバーの詳細については、「UserData」をご覧ください。For a description of this member, see UserData.

(継承元 Control)
IDataBindingsAccessor.DataBindings

このメンバーの詳細については、「DataBindings」をご覧ください。For a description of this member, see DataBindings.

(継承元 Control)
IDataBindingsAccessor.HasDataBindings

このメンバーの詳細については、「HasDataBindings」をご覧ください。For a description of this member, see HasDataBindings.

(継承元 Control)
IExpressionsAccessor.Expressions

このメンバーの詳細については、「Expressions」をご覧ください。For a description of this member, see Expressions.

(継承元 Control)
IExpressionsAccessor.HasExpressions

このメンバーの詳細については、「HasExpressions」をご覧ください。For a description of this member, see HasExpressions.

(継承元 Control)
IParserAccessor.AddParsedSubObject(Object)

このメンバーの詳細については、「AddParsedSubObject(Object)」をご覧ください。For a description of this member, see AddParsedSubObject(Object).

(継承元 Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

DropDownList コントロールのポストされたデータを処理します。Processes posted data for the DropDownList control.

IPostBackDataHandler.RaisePostDataChangedEvent()

ポストバック時に DropDownList コントロールのイベントを発生させます。Raises events for the DropDownList control on postback.

拡張メソッド

FindDataSourceControl(Control)

指定されたコントロールのデータ コントロールに関連付けられているデータ ソースを返します。Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

指定されたコントロールの名前付けコンテナー内にある、指定された列のフィールド テンプレートを返します。Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

格納しているデータ コントロールのメタテーブル オブジェクトを返します。Returns the metatable object for the containing data control.

適用対象

こちらもご覧ください