QueryStringParameter Costruttori

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inizializza una nuova istanza della classe QueryStringParameter.

Overload

QueryStringParameter()	Inizializza una nuova istanza senza nome della classe QueryStringParameter.
QueryStringParameter(QueryStringParameter)	Inizializza una nuova istanza della classe QueryStringParameter utilizzando i valori dell'istanza specificata dal parametro `original`.
QueryStringParameter(String, String)	Inizializza una nuova istanza denominata della classe QueryStringParameter, utilizzando la stringa specificata per identificare il campo della stringa di query per l'associazione.
QueryStringParameter(String, DbType, String)	Inizializza una nuova istanza denominata della classe QueryStringParameter, utilizzando il campo della stringa di query specificata e il tipo di dati del parametro.
QueryStringParameter(String, TypeCode, String)	Inizializza una nuova istanza denominata e fortemente tipizzata della classe QueryStringParameter, utilizzando la stringa specificata per identificare il campo della stringa di query per l'associazione.

QueryStringParameter()

Inizializza una nuova istanza senza nome della classe QueryStringParameter.

public:
 QueryStringParameter();

public QueryStringParameter ();

Public Sub New ()

Esempio

Nell'esempio seguente viene illustrato come usare il QueryStringParameter costruttore per creare un nuovo QueryStringParameter parametro e aggiungerlo alla SelectParameters raccolta di un AccessDataSource controllo.

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)

L'oggetto QueryStringParameter viene aggiunto al AccessDataSource controllo e viene dichiarato in una pagina Web ASP.NET. Il ListBox controllo usa il AccessDataSource controllo per associare e visualizzare i dati ogni volta che viene richiesta la pagina con una stringa di query contenente un campo denominato empId e con un valore corrispondente.

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

Commenti

Un QueryStringParameter oggetto creato utilizzando il QueryStringParameter costruttore viene inizializzato con i valori predefiniti per tutte le relative proprietà. Le proprietà vengono inizializzate nel modo seguente:

QueryStringField viene inizializzato in una stringa vuota ("").
Name viene inizializzato in una stringa vuota ("").
L'enumerazione Type viene inizializzata su TypeCode.Object.
L'enumerazione Direction viene inizializzata su Input.
L'enumerazione DefaultValue viene inizializzata su null.

Si applica a

QueryStringParameter(QueryStringParameter)

Inizializza una nuova istanza della classe QueryStringParameter utilizzando i valori dell'istanza specificata dal parametro 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)

Parametri

original: QueryStringParameter

Istanza QueryStringParameter da cui viene inizializzata l'istanza corrente.

Commenti

Il QueryStringParameter costruttore è un costruttore di copia protetto usato per clonare un'istanza QueryStringParameter di . I valori delle QueryStringFieldproprietà , Namee Type vengono trasferiti alla nuova istanza.

Vedi anche

Clone()

Si applica a

QueryStringParameter(String, String)

Inizializza una nuova istanza denominata della classe QueryStringParameter, utilizzando la stringa specificata per identificare il campo della stringa di query per l'associazione.

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)

Parametri

name: String

Nome del parametro.

queryStringField: String

Nome del campo della stringa di query a cui è associato l'oggetto parametro. Il valore predefinito è una stringa vuota ("").

Esempio

Nell'esempio seguente viene illustrato come creare due QueryStringParameter oggetti usando il QueryStringParameter costruttore e aggiungerli alla raccolta di SelectParameters un AccessDataSource controllo. Un GridView controllo visualizza i dati se i employee campi della stringa di query e country vengono passati con la richiesta e se hanno valori validi.

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

Commenti

Un QueryStringParameter oggetto creato utilizzando il QueryStringParameter costruttore viene inizializzato con il nome del parametro specificato che identifica il campo della stringa di query a cui il parametro è associato. Le Type proprietà e Direction vengono inizializzate con i valori predefiniti.

Vedi anche

Si applica a

QueryStringParameter(String, DbType, String)

Inizializza una nuova istanza denominata della classe QueryStringParameter, utilizzando il campo della stringa di query specificata e il tipo di dati del parametro.

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)

Parametri

name: String

Nome del parametro.

dbType: DbType

Tipo di dati del parametro.

queryStringField: String

Nome del campo della stringa di query a cui è associato l'oggetto parametro. Il valore predefinito è una stringa vuota ("").

Si applica a

QueryStringParameter(String, TypeCode, String)

Inizializza una nuova istanza denominata e fortemente tipizzata della classe QueryStringParameter, utilizzando la stringa specificata per identificare il campo della stringa di query per l'associazione.

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)

Parametri

name: String

Nome del parametro.

type: TypeCode

Tipo rappresentato dal parametro. Il valore predefinito è Object.

queryStringField: String

Nome del campo della stringa di query a cui è associato l'oggetto parametro. Il valore predefinito è una stringa vuota ("").

Esempio

Nell'esempio seguente viene illustrato come creare un QueryStringParameter oggetto usando il QueryStringParameter costruttore e aggiungerlo alla raccolta di FilterParameters un AccessDataSource controllo. Un GridView controllo visualizza i dati se i employee campi della stringa di query e country vengono passati con la richiesta e se hanno valori validi.

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

Commenti

Un QueryStringParameter oggetto creato utilizzando il QueryStringParameter costruttore viene inizializzato con il nome del parametro specificato, il tipo di parametro e una stringa che identifica il campo della stringa di query a cui il parametro è associato. Le Direction proprietà e ConvertEmptyStringToNull vengono inizializzate con i valori predefiniti.

Vedi anche

Si applica a

Condividi tramite

QueryStringParameter Costruttori

Definizione

Overload

QueryStringParameter()

Esempio

Commenti

Si applica a

QueryStringParameter(QueryStringParameter)

Parametri

Commenti

Vedi anche

Si applica a

QueryStringParameter(String, String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

QueryStringParameter(String, DbType, String)

Parametri

Si applica a

QueryStringParameter(String, TypeCode, String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive