ControlParameter ControlParameter ControlParameter ControlParameter Class

定義

Control のプロパティの値をパラメーター オブジェクトにバインドします。Binds the value of a property of a Control to a parameter object.

public ref class ControlParameter : System::Web::UI::WebControls::Parameter
public class ControlParameter : System.Web.UI.WebControls.Parameter
type ControlParameter = class
    inherit Parameter
Public Class ControlParameter
Inherits Parameter
継承
ControlParameterControlParameterControlParameterControlParameter

次のコード例は、使用する方法を示します、ControlParameterに表示されるデータのバインド先のオブジェクトをListBoxコントロールの選択した値をDropDownList宣言型のシナリオでのコントロール。The following code example demonstrates how to use a ControlParameter object to bind data displayed in a ListBox control to the selected value of a DropDownList control in a declarative scenario. ControlParameterオブジェクトに追加されます、SelectParametersのコレクション、 SqlDataSource 、フォーム上の制御に対応して、"@Title"内のプレース ホルダー テキスト、SelectCommandプロパティ。The ControlParameter object is added to the SelectParameters collection of the SqlDataSource control on the form, and corresponds to the "@Title" placeholder text in the SelectCommand property.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

注釈

使用することができます、ControlParameterクラスの値をバインドする、ControlプロパティなどSelectedValueまたはSelectedIndex、パラメーター化 SQL クエリ、ビジネス オブジェクト メソッド、またはフィルター式で使用されるパラメーターにします。You can use the ControlParameter class to bind the value of a Control property, such as SelectedValue or SelectedIndex, to a parameter that is used in a parameterized SQL query, business object method, or filtering expression.

ControlParameterクラスから継承しただけでなく 2 つのプロパティを提供する、Parameterクラス:ControlIDPropertyNameします。The ControlParameter class provides two properties in addition to those inherited from the Parameter class: ControlID and PropertyName. ControlIDプロパティを識別するControlインスタンスにバインドして、PropertyNameプロパティのパブリック プロパティを識別する、Control元となる、ControlParameterクラス値を取得します。The ControlID property identifies which Control instance to bind to and the PropertyName property identifies the public property of the Control from which the ControlParameter class retrieves a value.

コンストラクター

ControlParameter() ControlParameter() ControlParameter() ControlParameter()

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

ControlParameter(ControlParameter) ControlParameter(ControlParameter) ControlParameter(ControlParameter) ControlParameter(ControlParameter)

指定したインスタンスの値を使用して、ControlParameter クラスの新しいインスタンスを初期化します。Initializes a new instance of the ControlParameter class with values from the specified instance.

ControlParameter(String, DbType, String, String) ControlParameter(String, DbType, String, String) ControlParameter(String, DbType, String, String) ControlParameter(String, DbType, String, String)

指定したパラメーター名、データベース型、コントロール ID、およびプロパティ名を使用して、ControlParameter クラスの新しいインスタンスを初期化します。Initializes a new instance of the ControlParameter class by using the specified parameter name, database type, control ID, and property name.

ControlParameter(String, String) ControlParameter(String, String) ControlParameter(String, String) ControlParameter(String, String)

バインド先のコントロールを識別する指定されたコントロール名を使用して、ControlParameter クラスの名前付きの新しいインスタンスを初期化します。Initializes a new named instance of the ControlParameter class, using the specified control name to identify which control to bind to.

ControlParameter(String, String, String) ControlParameter(String, String, String) ControlParameter(String, String, String) ControlParameter(String, String, String)

指定されたプロパティ名およびバインド先のコントロールを識別するコントロール名を使用して、ControlParameter クラスの名前付きの新しいインスタンスを初期化します。Initializes a new named instance of the ControlParameter class, using the specified property name and control name to identify which control to bind to.

ControlParameter(String, TypeCode, String, String) ControlParameter(String, TypeCode, String, String) ControlParameter(String, TypeCode, String, String) ControlParameter(String, TypeCode, String, String)

指定されたプロパティ名およびバインド先のコントロールを識別するコントロール名を使用して、ControlParameter クラスの厳密に型指定された名前付きの新しいインスタンスを初期化します。Initializes a new named and strongly typed instance of the ControlParameter class, using the specified property name and control name to identify which control to bind to.

プロパティ

ControlID ControlID ControlID ControlID

ControlParameter オブジェクトのバインド先のコントロールの名前を指定します。Specifies the name of the control that the ControlParameter object binds to.

ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull

Parameter オブジェクトのバインド先の値が Empty の場合に、その値を null に変換する必要があるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the value that the Parameter object is bound to should be converted to null if it is Empty.

(Inherited from Parameter)
DbType DbType DbType DbType

パラメーターのデータベース型を取得または設定します。Gets or sets the database type of the parameter.

(Inherited from Parameter)
DefaultValue DefaultValue DefaultValue DefaultValue

パラメーターの既定値を指定します。Evaluate(HttpContext, Control) メソッドの呼び出し時に、パラメーターはこの値にバインドされ、初期化前の状態に戻されます。Specifies a default value for the parameter, should the value that the parameter is bound to be uninitialized when the Evaluate(HttpContext, Control) method is called.

(Inherited from Parameter)
Direction Direction Direction Direction

Parameter オブジェクトを使用して値をコントロールにバインドするかどうか、またはそのコントロールを使用して値を変更できるかどうかを示します。Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value.

(Inherited from Parameter)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。Gets a value indicating whether the Parameter object is saving changes to its view state.

(Inherited from Parameter)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。Gets a value indicating whether the Parameter object is saving changes to its view state.

(Inherited from Parameter)
Name Name Name Name

パラメーターの名前を取得または設定します。Gets or sets the name of the parameter.

(Inherited from Parameter)
PropertyName PropertyName PropertyName PropertyName

ControlID オブジェクトがバインドする、ControlParameter プロパティにより識別されるコントロールのプロパティの名前を取得または設定します。Gets or sets the property name of the control identified by the ControlID property that the ControlParameter object binds to.

Size Size Size Size

パラメーターのサイズを取得または設定します。Gets or sets the size of the parameter.

(Inherited from Parameter)
Type Type Type Type

パラメーターの型を取得または設定します。Gets or sets the type of the parameter.

(Inherited from Parameter)
ViewState ViewState ViewState ViewState

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

(Inherited from Parameter)

メソッド

Clone() Clone() Clone() Clone()

現在の ControlParameter インスタンスの複製を返します。Returns a duplicate of the current ControlParameter instance.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control)

ControlParameter オブジェクトの値を更新して返します。Updates and returns the value of the ControlParameter object.

GetDatabaseType() GetDatabaseType() GetDatabaseType() GetDatabaseType()

現在の DbType インスタンスの CLR 型と等価な Parameter 値を取得します。Gets the DbType value that is equivalent to the CLR type of the current Parameter instance.

(Inherited from Parameter)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

データ ソース ビューの、以前保存したビューステートを復元します。Restores the data source view's previously saved view state.

(Inherited from Parameter)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnParameterChanged() OnParameterChanged() OnParameterChanged() OnParameterChanged()

OnParametersChanged(EventArgs) オブジェクトを格納する ParameterCollection コレクションの Parameter メソッドを呼び出します。Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

(Inherited from Parameter)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

ページがサーバーにポスト バックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Inherited from Parameter)
SetDirty() SetDirty() SetDirty() SetDirty()

Parameter オブジェクトの状態がビューステートで記録されるように、このオブジェクトをマークします。Marks the Parameter object so its state will be recorded in view state.

(Inherited from Parameter)
ToString() ToString() ToString() ToString()

このインスタンスの値を、それと等価の文字列形式に変換します。Converts the value of this instance to its equivalent string representation.

(Inherited from Parameter)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Inherited from Parameter)

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

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

現在の Parameter インスタンスの複製を返します。Returns a duplicate of the current Parameter instance.

(Inherited from Parameter)
IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

データ ソース ビューの、以前保存したビューステートを復元します。Restores the data source view's previously saved view state.

(Inherited from Parameter)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

ページがサーバーにポスト バックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Inherited from Parameter)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Inherited from Parameter)

適用対象

こちらもご覧ください