ControlParameter Classe

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’une propriété d’un Control objet de paramètre.

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

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

type ControlParameter = class
    inherit Parameter

Public Class ControlParameter
Inherits Parameter

Héritage: Object

Parameter
ControlParameter

Exemples

L’exemple de code suivant montre comment utiliser un ControlParameter objet pour lier des données affichées dans un ListBox contrôle à la valeur sélectionnée d’un DropDownList contrôle dans un scénario déclaratif. L’objet ControlParameter est ajouté à la SelectParameters collection du SqlDataSource contrôle sur le formulaire et correspond au texte d’espace réservé « @Title » dans la SelectCommand propriété.

<!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" runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

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

<!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" runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

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

Remarques

Vous pouvez utiliser la ControlParameter classe pour lier la valeur d’une Control propriété, par SelectedValue SelectedIndexexemple, à un paramètre utilisé dans une requête SQL paramétrable, une méthode d’objet métier ou une expression de filtrage.

La ControlParameter classe fournit deux propriétés en plus de celles héritées de la Parameter classe : ControlID et PropertyName. La ControlID propriété identifie Control l’instance à laquelle lier et la PropertyName propriété identifie la propriété publique à partir de Control laquelle la ControlParameter classe récupère une valeur.

Constructeurs

Nom	Description
ControlParameter()	Initialise une nouvelle instance sans nom de la ControlParameter classe.
ControlParameter(ControlParameter)	Initialise une nouvelle instance de la ControlParameter classe avec des valeurs de l’instance spécifiée.
ControlParameter(String, DbType, String, String)	Initialise une nouvelle instance de la ControlParameter classe à l’aide du nom de paramètre, du type de base de données, de l’ID de contrôle et du nom de propriété spécifiés.
ControlParameter(String, String, String)	Initialise une nouvelle instance nommée de la ControlParameter classe, en utilisant le nom de propriété et le nom de contrôle spécifiés pour identifier le contrôle à lier.
ControlParameter(String, String)	Initialise une nouvelle instance nommée de la ControlParameter classe à l’aide du nom de contrôle spécifié pour identifier le contrôle auquel établir une liaison.
ControlParameter(String, TypeCode, String, String)	Initialise une nouvelle instance nommée et fortement typée de la ControlParameter classe, à l’aide du nom de propriété et du nom de contrôle spécifiés pour identifier le contrôle à lier.

Propriétés

Nom	Description
ControlID	Spécifie le nom du contrôle auquel l’objet ControlParameter est lié.
ConvertEmptyStringToNull	Obtient ou définit une valeur indiquant si la valeur à laquelle l’objet Parameter est lié doit être convertie `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 Evaluate(HttpContext, Control) méthode 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)
PropertyName	Obtient ou définit le nom de propriété du contrôle identifié par la ControlID propriété à laquelle l’objet ControlParameter 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)
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un Parameter objet sur plusieurs requêtes pour la même page. (Hérité de Parameter)

Méthodes

Nom	Description
Clone()	Retourne un doublon de l’instance actuelle ControlParameter .
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 ControlParameter .
GetDatabaseType()	Obtient la DbType valeur équivalente au type CLR de l’instance actuelle Parameter . (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 OnParametersChanged(EventArgs) méthode de la ParameterCollection collection 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 de sorte 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 Parameter suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans l’objet du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de Parameter)

Implémentations d’interfaces explicites

Nom	Description
ICloneable.Clone()	Retourne un doublon de l’instance actuelle Parameter . (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 Parameter suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans l’objet du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de Parameter)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?