QueryStringParameter Constructores

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la clase QueryStringParameter.

Sobrecargas

QueryStringParameter()	Inicializa una nueva instancia sin nombre de la clase QueryStringParameter.
QueryStringParameter(QueryStringParameter)	Inicializa una nueva instancia de la clase QueryStringParameter, utilizando los valores de la instancia especificada por el parámetro `original`.
QueryStringParameter(String, String)	Inicializa una nueva instancia con nombre de la clase QueryStringParameter, utilizando la cadena especificada para identificar el campo de cadena de consulta al que se va a enlazar.
QueryStringParameter(String, DbType, String)	Inicializa una nueva instancia con nombre de la clase QueryStringParameter, utilizando el campo de cadena de consulta especificado y el tipo de datos del parámetro.
QueryStringParameter(String, TypeCode, String)	Inicializa una nueva instancia, fuertemente tipada y nombre, de la clase QueryStringParameter, utilizando la cadena especificada para identificar el campo de cadena de consulta al que se va a enlazar.

QueryStringParameter()

Inicializa una nueva instancia sin nombre de la clase QueryStringParameter.

public:
 QueryStringParameter();

public QueryStringParameter ();

Public Sub New ()

Ejemplos

En el ejemplo siguiente se muestra cómo usar el QueryStringParameter constructor para crear un nuevo QueryStringParameter parámetro y agregarlo a la SelectParameters colección de un AccessDataSource control.

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)

El QueryStringParameter objeto se agrega al AccessDataSource control y se declara en una página web de ASP.NET. El ListBox control usa el AccessDataSource control para enlazar y mostrar datos cada vez que se solicita la página con una cadena de consulta que contiene un campo denominado empId y que tiene un valor correspondiente.

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

Comentarios

Un QueryStringParameter objeto que se crea mediante el QueryStringParameter constructor se inicializa con valores predeterminados para todas sus propiedades. Las propiedades se inicializan de la siguiente manera:

QueryStringField se inicializa en una cadena vacía ("").
Name se inicializa en una cadena vacía ("").
Type se inicializa en TypeCode.Object.
Direction se inicializa en Input.
DefaultValue se inicializa en null.

Se aplica a

QueryStringParameter(QueryStringParameter)

Inicializa una nueva instancia de la clase QueryStringParameter, utilizando los valores de la instancia especificada por el 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

Instancia de QueryStringParameter a partir de la cual se inicializa la instancia actual.

Comentarios

El QueryStringParameter constructor es un constructor de copia protegido que se usa para clonar una QueryStringParameter instancia. Los valores de las QueryStringFieldpropiedades , Namey Type se transfieren a la nueva instancia.

Consulte también

Clone()

Se aplica a

QueryStringParameter(String, String)

Inicializa una nueva instancia con nombre de la clase QueryStringParameter, utilizando la cadena especificada para identificar el campo de cadena de consulta al que se va a enlazar.

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

El nombre del parámetro.

queryStringField: String

Nombre del campo de cadena de consulta al que se enlaza el objeto de parámetro. El valor predeterminado es una cadena vacía ("").

Ejemplos

En el ejemplo siguiente se muestra cómo crear dos QueryStringParameter objetos mediante el QueryStringParameter constructor y agregarlos a la colección de SelectParameters un AccessDataSource control. Un GridView control muestra los datos si los campos de cadena employee de consulta y country se pasan con la solicitud y si tienen 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>

Comentarios

Un QueryStringParameter objeto creado mediante el QueryStringParameter constructor se inicializa con el nombre de parámetro especificado que identifica el campo de cadena de consulta al que se enlaza el parámetro. Las Type propiedades y Direction se inicializan con valores predeterminados.

Consulte también

Se aplica a

QueryStringParameter(String, DbType, String)

Inicializa una nueva instancia con nombre de la clase QueryStringParameter, utilizando el campo de cadena de consulta especificado y el tipo de datos del 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

El nombre del parámetro.

dbType: DbType

El tipo de datos del parámetro.

queryStringField: String

Nombre del campo de cadena de consulta al que se enlaza el objeto de parámetro. El valor predeterminado es una cadena vacía ("").

Se aplica a

QueryStringParameter(String, TypeCode, String)

Inicializa una nueva instancia, fuertemente tipada y nombre, de la clase QueryStringParameter, utilizando la cadena especificada para identificar el campo de cadena de consulta al que se va a enlazar.

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

El nombre del parámetro.

type: TypeCode

Tipo que el parámetro representa. De manera predeterminada, es Object.

queryStringField: String

Nombre del campo de cadena de consulta al que se enlaza el objeto de parámetro. El valor predeterminado es una cadena vacía ("").

Ejemplos

En el ejemplo siguiente se muestra cómo crear un QueryStringParameter objeto mediante el QueryStringParameter constructor y agregarlo a la colección de FilterParameters un AccessDataSource control. Un GridView control muestra los datos si los campos de cadena employee de consulta y country se pasan con la solicitud y si tienen 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>

Comentarios

Un QueryStringParameter objeto que se crea mediante el QueryStringParameter constructor se inicializa con el nombre de parámetro especificado, el tipo de parámetro y una cadena que identifica el campo de cadena de consulta al que se enlaza el parámetro. Las Direction propiedades y ConvertEmptyStringToNull se inicializan con valores predeterminados.

Consulte también

Se aplica a

QueryStringParameter Constructores

Definición

Sobrecargas

QueryStringParameter()

Ejemplos

Comentarios

Se aplica a

QueryStringParameter(QueryStringParameter)

Parámetros

Comentarios

Consulte también

Se aplica a

QueryStringParameter(String, String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

QueryStringParameter(String, DbType, String)

Parámetros

Se aplica a

QueryStringParameter(String, TypeCode, String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales