Partilhar via


QueryStringParameter Construtores

Definição

Inicializa uma nova instância da classe QueryStringParameter.

Sobrecargas

QueryStringParameter()

Inicializa uma nova instância não nomeada da classe QueryStringParameter.

QueryStringParameter(QueryStringParameter)

Inicializa uma nova instância da classe QueryStringParameter usando os valores da instância especificada pelo parâmetro original.

QueryStringParameter(String, String)

Inicializa uma nova instância nomeada da classe QueryStringParameter, usando a cadeia de caracteres especificada para identificar o campo de cadeia de caracteres de consulta ao qual associar.

QueryStringParameter(String, DbType, String)

Inicializa uma nova instância nomeada da classe QueryStringParameter, usando o campo de cadeia de caracteres de consulta especificado e o tipo de dados do parâmetro.

QueryStringParameter(String, TypeCode, String)

Inicializa uma nova instância nomeada e fortemente tipada da classe QueryStringParameter, usando a cadeia de caracteres especificada para identificar o campo de cadeia de caracteres de consulta ao qual associar.

QueryStringParameter()

Inicializa uma nova instância não nomeada da classe QueryStringParameter.

public:
 QueryStringParameter();
public QueryStringParameter ();
Public Sub New ()

Exemplos

O exemplo a SelectParameters seguir mostra como usar o QueryStringParameter construtor para criar um novo QueryStringParameter parâmetro e adicioná-lo à coleção de um AccessDataSource controle.

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)

O QueryStringParameter objeto é adicionado ao AccessDataSource controle e é declarado em uma página da Web ASP.NET. O ListBox controle usa o AccessDataSource controle para associar e exibir dados sempre que a página é solicitada com uma cadeia de caracteres de consulta que contém um campo nomeado empId e que tem um valor correspondente.

<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 = ?" />

Comentários

Um QueryStringParameter objeto criado usando o QueryStringParameter construtor é inicializado com valores padrão para todas as suas propriedades. As propriedades são inicializadas da seguinte maneira:

Aplica-se a

QueryStringParameter(QueryStringParameter)

Inicializa uma nova instância da classe QueryStringParameter usando os valores da instância especificada pelo parâmetro 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)

Parâmetros

original
QueryStringParameter

Uma instância do QueryStringParameter na qual a instância atual é inicializada.

Comentários

O QueryStringParameter construtor é um construtor de cópia protegido que é usado para clonar uma QueryStringParameter instância. Os valores de QueryStringField, Namee Type propriedades são transferidos para a nova instância.

Confira também

Aplica-se a

QueryStringParameter(String, String)

Inicializa uma nova instância nomeada da classe QueryStringParameter, usando a cadeia de caracteres especificada para identificar o campo de cadeia de caracteres de consulta ao qual associar.

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)

Parâmetros

name
String

O nome do parâmetro.

queryStringField
String

O nome do campo da cadeia de consulta ao qual o objeto de parâmetro está associado. O padrão é uma cadeia de caracteres vazia ("").

Exemplos

O exemplo a seguir mostra como criar dois QueryStringParameter objetos usando o QueryStringParameter construtor e adicioná-los à coleção de SelectParameters um AccessDataSource controle. Um GridView controle exibirá dados se os campos e country cadeia employee de caracteres de consulta forem passados com a solicitação e se eles tiverem valores válidos.

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

Comentários

Um QueryStringParameter objeto criado usando o QueryStringParameter construtor é inicializado com o nome do parâmetro especificado que identifica o campo cadeia de caracteres de consulta ao qual o parâmetro se associa. As propriedades e as Type Direction propriedades são inicializadas com valores padrão.

Confira também

Aplica-se a

QueryStringParameter(String, DbType, String)

Inicializa uma nova instância nomeada da classe QueryStringParameter, usando o campo de cadeia de caracteres de consulta especificado e o tipo de dados do parâmetro.

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)

Parâmetros

name
String

O nome do parâmetro.

dbType
DbType

O tipo de dados do parâmetro.

queryStringField
String

O nome do campo da cadeia de consulta ao qual o objeto de parâmetro está associado. O padrão é uma cadeia de caracteres vazia ("").

Aplica-se a

QueryStringParameter(String, TypeCode, String)

Inicializa uma nova instância nomeada e fortemente tipada da classe QueryStringParameter, usando a cadeia de caracteres especificada para identificar o campo de cadeia de caracteres de consulta ao qual associar.

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)

Parâmetros

name
String

O nome do parâmetro.

type
TypeCode

O tipo que o parâmetro representa. O padrão é Object.

queryStringField
String

O nome do campo da cadeia de consulta ao qual o objeto de parâmetro está associado. O padrão é uma cadeia de caracteres vazia ("").

Exemplos

O exemplo a seguir mostra como criar um QueryStringParameter objeto usando o QueryStringParameter construtor e adicioná-lo à coleção de FilterParameters um AccessDataSource controle. Um GridView controle exibirá dados se os campos e country cadeia employee de caracteres de consulta forem passados com a solicitação e se eles tiverem valores válidos.

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

Comentários

Um QueryStringParameter objeto criado usando o QueryStringParameter construtor é inicializado com o nome do parâmetro especificado, o tipo de parâmetro e uma cadeia de caracteres que identifica o campo cadeia de caracteres de consulta ao qual o parâmetro se associa. As propriedades e as Direction ConvertEmptyStringToNull propriedades são inicializadas com valores padrão.

Confira também

Aplica-se a