QueryStringParameter 构造函数

定义

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

程序集:: System.Web.dll

重要

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

重载

名称	说明
QueryStringParameter()	初始化 QueryStringParameter 类的新未命名实例。
QueryStringParameter(QueryStringParameter)	使用 QueryStringParameter 参数指定的实例的值初始化 `original` 类的新实例。
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 网页中声明。每当请求页面时，ListBox该AccessDataSource控件使用包含命名empId字段且具有相应值的字段的查询字符串来绑定和显示数据。

<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)

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

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 实例的受保护复制构造函数。 QueryStringField Name值和Type属性将传输到新实例。

另请参阅

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 。

另请参阅

适用于

反馈

此页面是否有帮助？