QueryStringParameter Конструкторы

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Инициализирует новый экземпляр класса QueryStringParameter.

Перегрузки

Имя	Описание
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 управления отображает данные, если employeecountry поля строки запроса передаются с запросом и имеют допустимые значения.

<%@ 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 управления отображает данные, если employeecountry поля строки запроса передаются с запросом и имеют допустимые значения.

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

Параметры

Примеры

Комментарии

См. также раздел

Применяется к