Partager via

QueryStringParameter Constructeurs

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Initialise une nouvelle instance de la classe QueryStringParameter.

Surcharges

QueryStringParameter()

Initialise une nouvelle instance sans nom de la classe QueryStringParameter.
QueryStringParameter(QueryStringParameter)

Initialise une nouvelle instance de la classe QueryStringParameter en utilisant les valeurs de l'instance spécifiée par le paramètre original.
QueryStringParameter(String, String)

Initialise une nouvelle instance nommée de la classe QueryStringParameter, à l'aide de la chaîne spécifiée pour identifier le champ de chaîne de requête à lier.
QueryStringParameter(String, DbType, String)

Initialise une nouvelle instance nommée de la classe QueryStringParameter, à l'aide du champ de chaîne de requête spécifié et du type de données du paramètre.
QueryStringParameter(String, TypeCode, String)

Initialise une nouvelle instance nommée et fortement typée de la classe QueryStringParameter, à l'aide de la chaîne spécifiée pour identifier le champ de chaîne de requête à lier.

QueryStringParameter()

Initialise une nouvelle instance sans nom de la classe QueryStringParameter.

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

Exemples

L’exemple suivant montre comment utiliser le QueryStringParameter constructeur pour créer un paramètre QueryStringParameter et l’ajouter à la SelectParameters collection d’un AccessDataSource contrôle.

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’objet QueryStringParameter est ajouté au AccessDataSource contrôle et déclaré dans une page Web ASP.NET. Le ListBox contrôle utilise le AccessDataSource contrôle pour lier et afficher des données chaque fois que la page est demandée avec une chaîne de requête qui contient un champ nommé empId et qui a une valeur correspondante.

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

Remarques

Un QueryStringParameter objet créé à l’aide du QueryStringParameter constructeur est initialisé avec des valeurs par défaut pour toutes ses propriétés. Les propriétés sont initialisées comme suit :

S’applique à

QueryStringParameter(QueryStringParameter)

Initialise une nouvelle instance de la classe QueryStringParameter en utilisant les valeurs de l'instance spécifiée par le paramètre 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)

Paramètres

original
QueryStringParameter

Instance de QueryStringParameter à partir de laquelle l'instance actuelle est initialisée.

Remarques

Le QueryStringParameter constructeur est un constructeur de copie protégée utilisé pour cloner une QueryStringParameter instance. Les valeurs des QueryStringFieldpropriétés , Nameet Type sont transférées vers la nouvelle instance.

Voir aussi

S’applique à

QueryStringParameter(String, String)

Initialise une nouvelle instance nommée de la classe QueryStringParameter, à l'aide de la chaîne spécifiée pour identifier le champ de chaîne de requête à lier.

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)

Paramètres

name
String

Le nom du paramètre.

queryStringField
String

Nom du champ de chaîne de requête auquel l'objet Parameter est lié. La valeur par défaut est une chaîne vide ("").

Exemples

L’exemple suivant montre comment créer deux QueryStringParameter objets à l’aide du QueryStringParameter constructeur et les ajouter à la collection d’un AccessDataSourceSelectParameters contrôle. Un GridView contrôle affiche des données si les employee champs de chaîne de requête et country sont transmis avec la demande et s’ils ont des valeurs valides.

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

Remarques

Un QueryStringParameter objet créé à l’aide du QueryStringParameter constructeur est initialisé avec le nom de paramètre spécifié qui identifie le champ de chaîne de requête auquel le paramètre est lié. Les Type propriétés et Direction sont initialisées avec des valeurs par défaut.

Voir aussi

S’applique à

QueryStringParameter(String, DbType, String)

Initialise une nouvelle instance nommée de la classe QueryStringParameter, à l'aide du champ de chaîne de requête spécifié et du type de données du paramètre.

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)

Paramètres

name
String

Le nom du paramètre.

dbType
DbType

Type de données du paramètre.

queryStringField
String

Nom du champ de chaîne de requête auquel l'objet Parameter est lié. La valeur par défaut est une chaîne vide ("").

S’applique à

QueryStringParameter(String, TypeCode, String)

Initialise une nouvelle instance nommée et fortement typée de la classe QueryStringParameter, à l'aide de la chaîne spécifiée pour identifier le champ de chaîne de requête à lier.

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)

Paramètres

name
String

Le nom du paramètre.

type
TypeCode

Type que le paramètre représente. La valeur par défaut est Object.

queryStringField
String

Nom du champ de chaîne de requête auquel l'objet Parameter est lié. La valeur par défaut est une chaîne vide ("").

Exemples

L’exemple suivant montre comment créer un QueryStringParameter objet à l’aide du QueryStringParameter constructeur et l’ajouter à la collection d’un AccessDataSourceFilterParameters contrôle. Un GridView contrôle affiche des données si les employee champs de chaîne de requête et country sont transmis avec la demande et s’ils ont des valeurs valides.

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

Remarques

Un QueryStringParameter objet créé à l’aide du QueryStringParameter constructeur est initialisé avec le nom de paramètre spécifié, le type de paramètre et une chaîne qui identifie le champ de chaîne de requête auquel le paramètre est lié. Les Direction propriétés et ConvertEmptyStringToNull sont initialisées avec des valeurs par défaut.

Voir aussi

S’applique à