QueryStringParameter 构造函数

参考

定义

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

程序集:: System.Web.dll

重要

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

重载

QueryStringParameter()	初始化 QueryStringParameter 类的未命名新实例。
QueryStringParameter(QueryStringParameter)	使用 `original` 参数指定的实例的值初始化 QueryStringParameter 类的新实例。
QueryStringParameter(String, String)	使用指定的字符串来标识要绑定到的查询字符串字段，初始化 QueryStringParameter 类的新命名实例。
QueryStringParameter(String, DbType, String)	使用指定的查询字符串字段和参数的数据类型，初始化 QueryStringParameter 类的新命名实例。
QueryStringParameter(String, TypeCode, String)	使用指定的字符串来标识要绑定到的查询字符串字段，初始化 QueryStringParameter 类的新强类型命名实例。

QueryStringParameter()

初始化 QueryStringParameter 类的未命名新实例。

public:
 QueryStringParameter();

public QueryStringParameter ();

Public Sub New ()

示例

以下示例演示如何使用 QueryStringParameter 构造函数创建新 QueryStringParameter 参数并将其添加到 SelectParameters 控件的 AccessDataSource 集合。

QueryStringParameter empIdParam = new QueryStringParameter();
empIdParam.Name = "empId";
empIdParam.QueryStringField = "empId";

AccessDataSource1.SelectParameters.Add(empIdParam);

Dim empIdParam As New QueryStringParameter()
empIdParam.Name = "empId"
empIdParam.QueryStringField = "empId"

AccessDataSource1.SelectParameters.Add(empIdParam)

对象 QueryStringParameter 将添加到控件， AccessDataSource 并在 ASP.NET 网页中声明。每当使用包含名为 empId 且具有相应值的字段的查询字符串请求页面时，控件ListBox都使用 AccessDataSource 控件来绑定和显示数据。

<asp:ListBox
  id ="ListBox2"
  runat="server"
  DataSourceID="AccessDataSource1"
  DataValueField="EmployeeID"
  DataTextField="LastName" />

<asp:AccessDataSource
  id="AccessDataSource1"
  runat="server"
  DataFile="Northwind.mdb"
  SelectCommand="Select EmployeeID, LastName From Employees where EmployeeID = ?" />

<asp:ListBox
  id ="ListBox2"
  runat="server"
  DataSourceID="AccessDataSource1"
  DataValueField="EmployeeID"
  DataTextField="LastName" />

<asp:AccessDataSource
  id="AccessDataSource1"
  runat="server"
  DataFile="Northwind.mdb"
  SelectCommand="Select EmployeeID, LastName From Employees where EmployeeID = ?" />

注解

QueryStringParameter使用 QueryStringParameter 构造函数创建的对象使用其所有属性的默认值进行初始化。这些属性的初始化方式如下：

QueryStringField 初始化为空字符串 (“”) 。
Name 初始化为空字符串 (“”) 。
Type 初始化为 TypeCode.Object。
Direction 初始化为 Input。
DefaultValue 初始化为 null。

适用于

QueryStringParameter(QueryStringParameter)

使用 original 参数指定的实例的值初始化 QueryStringParameter 类的新实例。

protected:
 QueryStringParameter(System::Web::UI::WebControls::QueryStringParameter ^ original);

protected QueryStringParameter (System.Web.UI.WebControls.QueryStringParameter original);

new System.Web.UI.WebControls.QueryStringParameter : System.Web.UI.WebControls.QueryStringParameter -> System.Web.UI.WebControls.QueryStringParameter

Protected Sub New (original As QueryStringParameter)

参数

original: QueryStringParameter

一个 QueryStringParameter 实例，将从该实例初始化当前实例。

注解

构造 QueryStringParameter 函数是用于克隆实例的 QueryStringParameter 受保护复制构造函数。、 Name和 Type 属性的值QueryStringField将传输到新实例。

另请参阅

Clone()

适用于

QueryStringParameter(String, String)

使用指定的字符串来标识要绑定到的查询字符串字段，初始化 QueryStringParameter 类的新命名实例。

public:
 QueryStringParameter(System::String ^ name, System::String ^ queryStringField);

public QueryStringParameter (string name, string queryStringField);

new System.Web.UI.WebControls.QueryStringParameter : string * string -> System.Web.UI.WebControls.QueryStringParameter

Public Sub New (name As String, queryStringField As String)

参数

name: String

参数的名称。

queryStringField: String

参数对象要绑定到的查询字符串字段的名称。默认值为空字符串("")。

示例

下面的示例演示如何使用 QueryStringParameter 构造函数创建两QueryStringParameter个 AccessDataSource 对象，并将其添加到控件的 SelectParameters 集合。 GridView如果 employee 和 country 查询字符串字段随请求一起传递，并且它们具有有效值，控件将显示数据。

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
    MyAccessDataSource.SelectParameters.Add(new QueryStringParameter("employee", "employee"));
    MyAccessDataSource.SelectParameters.Add(new QueryStringParameter("country",  "country"));
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String that includes employee=1&country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, FirstName 
                       FROM Employees
                       WHERE EmployeeID = ? AND Country = ?">
      </asp:accessdatasource>

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

<%@ Page language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
Private Sub Page_Load(sender As Object, e As EventArgs)
    Dim param1 As New QueryStringParameter("employee", "employee")
    MyAccessDataSource.SelectParameters.Add(param1)

    Dim param2 As New QueryStringParameter("country", "country")
    MyAccessDataSource.SelectParameters.Add(param2)
End Sub ' Page_Load
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String that includes employee=1&country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The SqlDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, FirstName
                       FROM Employees
                       WHERE EmployeeID = ? AND Country = ? ">
      </asp:accessdatasource>
    </form>
  </body>
</html>

注解

QueryStringParameter使用 QueryStringParameter 构造函数创建的对象使用指定的参数名称进行初始化，该名称标识该参数绑定到的查询字符串字段。使用 Type 默认值初始化和 Direction 属性。

另请参阅

适用于

QueryStringParameter(String, DbType, String)

使用指定的查询字符串字段和参数的数据类型，初始化 QueryStringParameter 类的新命名实例。

public:
 QueryStringParameter(System::String ^ name, System::Data::DbType dbType, System::String ^ queryStringField);

public QueryStringParameter (string name, System.Data.DbType dbType, string queryStringField);

new System.Web.UI.WebControls.QueryStringParameter : string * System.Data.DbType * string -> System.Web.UI.WebControls.QueryStringParameter

Public Sub New (name As String, dbType As DbType, queryStringField As String)

参数

name: String

参数的名称。

dbType: DbType

参数的数据类型。

queryStringField: String

参数对象要绑定到的查询字符串字段的名称。默认值为空字符串("")。

适用于

QueryStringParameter(String, TypeCode, String)

使用指定的字符串来标识要绑定到的查询字符串字段，初始化 QueryStringParameter 类的新强类型命名实例。

public:
 QueryStringParameter(System::String ^ name, TypeCode type, System::String ^ queryStringField);

public QueryStringParameter (string name, TypeCode type, string queryStringField);

new System.Web.UI.WebControls.QueryStringParameter : string * TypeCode * string -> System.Web.UI.WebControls.QueryStringParameter

Public Sub New (name As String, type As TypeCode, queryStringField As String)

参数

name: String

参数的名称。

type: TypeCode

该参数所表示的类型。默认值为 Object。

queryStringField: String

参数对象要绑定到的查询字符串字段的名称。默认值为空字符串("")。

示例

下面的示例演示如何使用 QueryStringParameter 构造函数创建 QueryStringParameter 对象并将其添加到AccessDataSource控件的 FilterParameters 集合。 GridView如果 employee 和 country 查询字符串字段随请求一起传递，并且它们具有有效值，控件将显示数据。

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
  QueryStringParameter countryFilter =
    new QueryStringParameter("country", TypeCode.String, "country");

  MyAccessDataSource.FilterParameters.Add(countryFilter);
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
      </asp:accessdatasource>
    </form>
  </body>
</html>

<%@ Page language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
Private Sub Page_Load(sender As Object, e As EventArgs)
  Dim countryFilter As QueryStringParameter
  countryFilter = New QueryStringParameter("country", TypeCode.String, "country")
  MyAccessDataSource.FilterParameters.Add(countryFilter)
End Sub ' Page_Load
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
      </asp:accessdatasource>
    </form>
  </body>
</html>

注解

QueryStringParameter使用 QueryStringParameter 构造函数创建的对象使用指定的参数名称、参数类型和标识参数绑定到的查询字符串字段的字符串进行初始化。使用 Direction 默认值初始化和 ConvertEmptyStringToNull 属性。

另请参阅

适用于

QueryStringParameter 构造函数

定义

重载

QueryStringParameter()

示例

注解

适用于

QueryStringParameter(QueryStringParameter)

参数

注解

另请参阅

适用于

QueryStringParameter(String, String)

参数

示例

注解

另请参阅

适用于

QueryStringParameter(String, DbType, String)

参数

适用于

QueryStringParameter(String, TypeCode, String)

参数

示例

注解

另请参阅

适用于

反馈

其他资源