QueryStringParameter Classe

Référence

Définition

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

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Lie la valeur d’un champ de chaîne de requête de requête HTTP à un objet de paramètre.

public ref class QueryStringParameter : System::Web::UI::WebControls::Parameter

public class QueryStringParameter : System.Web.UI.WebControls.Parameter

type QueryStringParameter = class
    inherit Parameter

Public Class QueryStringParameter
Inherits Parameter

Héritage: Object

Parameter
QueryStringParameter

Exemples

L’exemple suivant montre comment créer un objet QueryStringParameter à utiliser comme filtre lorsque vous affichez des données dans un contrôle GridView. Vous ajoutez l’objet QueryStringParameter à la collection FilterParameters du contrôle AccessDataSource. L’objet de paramètre lie la valeur du champ de chaîne de requête nommé country à sa chaîne FilterExpression. Comme aucune propriété DefaultValue n’est spécifiée pour le paramètre, si aucun champ nommé country n’est passé avec la chaîne de requête, le contrôle AccessDataSource lève une exception NullReferenceException. Si un champ nommé country est passé mais n’a aucune valeur, le contrôle GridView n’affiche aucune donnée.

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<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. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </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">

<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. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>

    </form>
  </body>
</html>

Remarques

Vous pouvez utiliser la classe QueryStringParameter pour lier la valeur d’un champ passé dans le cadre d’une chaîne de requête de requête HTTP à un paramètre utilisé dans une requête paramétrable ou une commande. Le champ est récupéré à partir de la collection QueryString.

Les contrôles qui lient des données au paramètre peuvent lever une exception si un objet QueryStringParameter est référencé, mais aucune paire nom/valeur de chaîne de requête correspondante n’est passée. De même, ils peuvent afficher aucune donnée si le nom du champ de chaîne de requête est transmis sans valeur correspondante. Pour éviter ces situations, définissez la propriété DefaultValue le cas échéant.

La classe QueryStringParameter fournit la propriété QueryStringField, qui identifie le nom de la valeur de chaîne de requête à lier. Il fournit également les propriétés héritées de la classe Parameter.

Important

La classe QueryStringParameter ne valide pas la valeur passée ; elle fournit la valeur brute. Toutefois, vous pouvez valider la valeur d’un objet QueryStringParameter dans un contrôle de source de données. Pour ce faire, gérez les Selecting, Updating, Insertingou Deleting événement du contrôle de source de données et vérifiez la valeur du paramètre dans le gestionnaire d’événements. Si la valeur du paramètre ne passe pas les tests de validation, vous pouvez annuler l’opération de données en définissant la propriété Cancel de la classe CancelEventArgs associée sur true.

Constructeurs

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, 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, 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, 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.

Propriétés

ConvertEmptyStringToNull	Obtient ou définit une valeur indiquant si la valeur à laquelle l’objet Parameter est lié doit être convertie en `null` si elle est Empty. (Hérité de Parameter)
DbType	Obtient ou définit le type de base de données du paramètre. (Hérité de Parameter)
DefaultValue	Spécifie une valeur par défaut pour le paramètre, si la valeur que le paramètre est lié à être non initialisée lorsque la méthode Evaluate(HttpContext, Control) est appelée. (Hérité de Parameter)
Direction	Indique si l’objet Parameter est utilisé pour lier une valeur à un contrôle, ou si le contrôle peut être utilisé pour modifier la valeur. (Hérité de Parameter)
IsTrackingViewState	Obtient une valeur indiquant si l’objet Parameter enregistre les modifications apportées à son état d’affichage. (Hérité de Parameter)
Name	Obtient ou définit le nom du paramètre. (Hérité de Parameter)
QueryStringField	Obtient ou définit le nom du champ de chaîne de requête auquel le paramètre est lié.
Size	Obtient ou définit la taille du paramètre. (Hérité de Parameter)
Type	Obtient ou définit le type du paramètre. (Hérité de Parameter)
ValidateInput	Obtient ou définit si la valeur du paramètre de chaîne de requête est validée ou non.
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un objet Parameter sur plusieurs requêtes pour la même page. (Hérité de Parameter)

Méthodes

Clone()	Retourne un doublon de l’instance de QueryStringParameter actuelle.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
Evaluate(HttpContext, Control)	Met à jour et retourne la valeur de l’objet QueryStringParameter.
GetDatabaseType()	Obtient la valeur DbType équivalente au type CLR de l’instance Parameter actuelle. (Hérité de Parameter)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
LoadViewState(Object)	Restaure l’état d’affichage précédemment enregistré de la vue de source de données. (Hérité de Parameter)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnParameterChanged()	Appelle la méthode OnParametersChanged(EventArgs) de la collection ParameterCollection qui contient l’objet Parameter. (Hérité de Parameter)
SaveViewState()	Enregistre les modifications apportées à l’état d’affichage de l’objet Parameter depuis la publication de la page sur le serveur. (Hérité de Parameter)
SetDirty()	Marque l’objet Parameter afin que son état soit enregistré dans l’état d’affichage. (Hérité de Parameter)
ToString()	Convertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente. (Hérité de Parameter)
TrackViewState()	Provoque le suivi des modifications apportées à l’état d’affichage de l’objet Parameter du contrôle afin qu’ils puissent être stockés dans l’objet ViewState du contrôle et conservés entre les demandes de la même page. (Hérité de Parameter)

Implémentations d’interfaces explicites

ICloneable.Clone()	Retourne un doublon de l’instance de Parameter actuelle. (Hérité de Parameter)
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si l’objet Parameter enregistre les modifications apportées à son état d’affichage. (Hérité de Parameter)
IStateManager.LoadViewState(Object)	Restaure l’état d’affichage précédemment enregistré de la vue de source de données. (Hérité de Parameter)
IStateManager.SaveViewState()	Enregistre les modifications apportées à l’état d’affichage de l’objet Parameter depuis la publication de la page sur le serveur. (Hérité de Parameter)
IStateManager.TrackViewState()	Provoque le suivi des modifications apportées à l’état d’affichage de l’objet Parameter du contrôle afin qu’ils puissent être stockés dans l’objet ViewState du contrôle et conservés entre les demandes de la même page. (Hérité de Parameter)

S’applique à

Partager via