ControlParameter 类

参考

定义

命名空间:: System.Web.UI.WebControls

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将 Control 的属性值绑定到参数对象。

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

继承: Object

Parameter
ControlParameter

示例

下面的代码示例演示如何使用 ControlParameter 对象将控件中显示的 ListBox 数据绑定到声明性方案中控件 DropDownList 的选定值。对象 ControlParameter 将添加到 SelectParameters 窗体上的控件的 SqlDataSource 集合中，并对应于属性中的 SelectCommand “@Title”占位符文本。

<!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 查询、业务对象方法或筛选表达式中使用的参数。

除了继承自类的属性外， Parameter 类ControlParameter还提供两个属性： ControlID 和 PropertyName。属性ControlID标识要绑定到的Control实例，PropertyName属性标识类从ControlParameter中检索值的公共属性Control。

构造函数

ControlParameter()	初始化 ControlParameter 类的未命名新实例。
ControlParameter(ControlParameter)	使用指定实例中的值初始化 ControlParameter 类的新实例。
ControlParameter(String, DbType, String, String)	使用指定的参数名称、数据库类型、控件 ID 以及属性名称初始化 ControlParameter 类的新实例。
ControlParameter(String, String)	使用指定的控件名称（此名称标识要绑定到哪一个控件）初始化 ControlParameter 类的新的命名实例。
ControlParameter(String, String, String)	使用指定的属性名和控件名称（此名称标识要绑定到哪一个控件）初始化 ControlParameter 类的新的命名实例。
ControlParameter(String, TypeCode, String, String)	使用指定的属性名和控件名称（此名称标识绑定到哪一个控件）初始化 ControlParameter 类的新命名的、强类型的实例。

属性

ControlID	指定 ControlParameter 对象绑定到的控件名称。
ConvertEmptyStringToNull	获取或设置一个值，该值指示在 Parameter 对象绑定到的值为 Empty 时是否应将其转换为 `null`。 (继承自 Parameter)
DbType	获取或设置参数的数据库类型。 (继承自 Parameter)
DefaultValue	指定参数的默认值（如果调用 Evaluate(HttpContext, Control) 方法时参数绑定到的值未被初始化）。 (继承自 Parameter)
Direction	指示 Parameter 对象是否用于将值绑定到控件，或者是否可以使用控件更改值。 (继承自 Parameter)
IsTrackingViewState	获取一个值，该值指示 Parameter 对象是否保存对其视图状态的更改。 (继承自 Parameter)
Name	获取或设置参数的名称。 (继承自 Parameter)
PropertyName	获取或设置由 ControlID 对象绑定到的 ControlParameter 属性标识的控件的属性名。
Size	获取或设置参数的大小。 (继承自 Parameter)
Type	获取或设置参数的类型。 (继承自 Parameter)
ViewState	获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原 Parameter 对象的视图状态。 (继承自 Parameter)

方法

Clone()	返回当前 ControlParameter 实例的副本。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Evaluate(HttpContext, Control)	更新并返回 ControlParameter 对象的值。
GetDatabaseType()	获取与当前 DbType 实例的 CLR 类型等效的 Parameter 值。 (继承自 Parameter)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
LoadViewState(Object)	将数据源视图还原为保存过的前一视图状态。 (继承自 Parameter)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnParameterChanged()	调用包含 OnParametersChanged(EventArgs) 对象的 ParameterCollection 集合的 Parameter 方法。 (继承自 Parameter)
SaveViewState()	自页回发到服务器开始，将更改保存到 Parameter 对象的视图状态。 (继承自 Parameter)
SetDirty()	标记 Parameter 对象，以便在视图状态中记录其状态。 (继承自 Parameter)
ToString()	将此实例的值转换为其等效的字符串表示形式。 (继承自 Parameter)
TrackViewState()	使 Parameter 对象跟踪其视图状态更改，以便这些更改可以存储在控件的 ViewState 对象中并在同一页面的不同请求间保留。 (继承自 Parameter)

显式接口实现

ICloneable.Clone()	返回当前 Parameter 实例的副本。 (继承自 Parameter)
IStateManager.IsTrackingViewState	获取一个值，该值指示 Parameter 对象是否保存对其视图状态的更改。 (继承自 Parameter)
IStateManager.LoadViewState(Object)	将数据源视图还原为保存过的前一视图状态。 (继承自 Parameter)
IStateManager.SaveViewState()	自页回发到服务器开始，将更改保存到 Parameter 对象的视图状态。 (继承自 Parameter)
IStateManager.TrackViewState()	使 Parameter 对象跟踪其视图状态更改，以便这些更改可以存储在控件的 ViewState 对象中并在同一页面的不同请求间保留。 (继承自 Parameter)

适用于

通过

ControlParameter 类

定义

示例

注解

构造函数

属性

方法

显式接口实现

适用于

另请参阅

其他资源