QueryStringParameter Construtores

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da QueryStringParameter classe.

Sobrecargas

Name	Description
QueryStringParameter()	Inicializa uma nova instância sem nome da QueryStringParameter classe.
QueryStringParameter(QueryStringParameter)	Inicializa uma nova instância da QueryStringParameter classe, usando os valores da instância especificados pelo `original` parâmetro.
QueryStringParameter(String, String)	Inicializa uma nova instância nomeada da QueryStringParameter classe, usando a cadeia especificada para identificar a que campo de sequência de consulta se deve associar.
QueryStringParameter(String, DbType, String)	Inicializa uma nova instância nomeada da QueryStringParameter classe, usando o campo de sequência de consulta especificado e o tipo de dado do parâmetro.
QueryStringParameter(String, TypeCode, String)	Inicializa uma nova instância nomeada e fortemente tipada da QueryStringParameter classe, usando a cadeia especificada para identificar a que campo de querystring deve ser associado.

QueryStringParameter()

Inicializa uma nova instância sem nome da QueryStringParameter classe.

public:
 QueryStringParameter();

public QueryStringParameter();

Public Sub New ()

Exemplos

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

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 objeto QueryStringParameter é adicionado ao controlo AccessDataSource e é declarado numa página ASP.NET Web. O ListBox controlo usa o AccessDataSource controlo para associar e mostrar dados sempre que a página é solicitada com uma string 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 = ?" />

Observações

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 forma:

QueryStringField é inicializado numa cadeia vazia ("").
Name é inicializado numa cadeia vazia ("").
Type é inicializado em TypeCode.Object.
Direction é inicializado em Input.
DefaultValue é inicializado em null.

Aplica-se a

QueryStringParameter(QueryStringParameter)

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

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 QueryStringParameter instância a partir da qual a instância atual é inicializada.

Observações

O QueryStringParameter construtor é um construtor de cópias protegidas que é usado para clonar uma QueryStringParameter instância. Os valores das QueryStringFieldpropriedades , Name, e Type são transferidos para a nova instância.

Ver também

Clone()

Aplica-se a

QueryStringParameter(String, String)

Inicializa uma nova instância nomeada da QueryStringParameter classe, usando a cadeia especificada para identificar a que campo de sequência de consulta se deve 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 de sequência de consulta ao qual o objeto parâmetro está ligado. O padrão é uma cadeia vazia ("").

Exemplos

O exemplo seguinte mostra como criar dois QueryStringParameter objetos usando o QueryStringParameter construtor e adicioná-los à coleção de SelectParameters um AccessDataSource controlo. Um GridView controlo apresenta dados se os employee campos e country da sequência de consulta forem passados com o pedido e se 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>

Observações

Um QueryStringParameter objeto criado usando o QueryStringParameter construtor é inicializado com o nome do parâmetro especificado que identifica o campo de sequência de consulta ao qual o parâmetro se liga. As Type propriedades e Direction são inicializadas com valores por defeito.

Ver também

Aplica-se a

QueryStringParameter(String, DbType, String)

Inicializa uma nova instância nomeada da QueryStringParameter classe, usando o campo de sequência de consulta especificado e o tipo de dado 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 de sequência de consulta ao qual o objeto parâmetro está ligado. O padrão é uma cadeia vazia ("").

Aplica-se a

QueryStringParameter(String, TypeCode, String)

Inicializa uma nova instância nomeada e fortemente tipada da QueryStringParameter classe, usando a cadeia especificada para identificar a que campo de querystring deve ser associado.

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. A predefinição é Object.

queryStringField: String

O nome do campo de sequência de consulta ao qual o objeto parâmetro está ligado. O padrão é uma cadeia vazia ("").

Exemplos

O exemplo seguinte mostra como criar um QueryStringParameter objeto usando o QueryStringParameter construtor e adicioná-lo à coleção de FilterParameters um AccessDataSource controlo. Um GridView controlo apresenta dados se os employee campos e country da sequência de consulta forem passados com o pedido e se 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>

Observações

Um QueryStringParameter objeto criado usando o QueryStringParameter construtor é inicializado com o nome do parâmetro especificado, o tipo de parâmetro e uma cadeia que identifica o campo de sequência de consulta ao qual o parâmetro se liga. As Direction propriedades e ConvertEmptyStringToNull são inicializadas com valores por defeito.

Ver também

Aplica-se a

Comentários

Esta página foi útil?