ControlParameter Classe

Définition

Lie la valeur d’une propriété de Control à un 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
ControlParameter

Exemples

L’exemple de code suivant montre comment utiliser un ControlParameter objet pour lier les 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é, telle que SelectedValue ou SelectedIndex, à 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 les instance à lier et la PropertyName propriété identifie la propriété publique du Control à partir de laquelle la ControlParameter classe récupère une valeur.

Constructeurs

ControlParameter()

Initialise une nouvelle instance sans nom de la classe ControlParameter.

ControlParameter(ControlParameter)

Initialise une nouvelle instance de la classe ControlParameter avec des valeurs de l'instance spécifiée.

ControlParameter(String, DbType, String, String)

Initialise une nouvelle instance de la classe ControlParameter en utilisant le nom de paramètre, le type de base de données, l'ID du contrôle et le nom de propriété spécifiés.

ControlParameter(String, String)

Initialise une nouvelle instance nommée de la classe ControlParameter à l'aide du nom de contrôle spécifié pour identifier le contrôle à lier.

ControlParameter(String, String, String)

Initialise une nouvelle instance nommée de la classe ControlParameter à l'aide du nom de la propriété spécifié et du nom du contrôle pour identifier le contrôle à lier.

ControlParameter(String, TypeCode, String, String)

Initialise une nouvelle instance nommée et fortement typée de la classe ControlParameter à l'aide du nom de la propriété spécifié et du nom du contrôle pour identifier le contrôle à lier.

Propriétés

ControlID

Spécifie le nom du contrôle auquel l'objet ControlParameter crée une liaison.

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, à condition que la valeur à laquelle le paramètre est lié à ne soit pas 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)
PropertyName

Obtient ou définit le nom de propriété du contrôle identifié par la propriété ControlID auquel l'objet ControlParameter crée une liaison.

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 objet Parameter entre plusieurs demandes de la même page.

(Hérité de Parameter)

Méthodes

Clone()

Retourne un doublon de l'instance de ControlParameter 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 ControlParameter.

GetDatabaseType()

Obtient la valeur DbType qui est équivalente au type CLR de l'instance Parameter actuelle.

(Hérité de Parameter)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour la vue de source de données.

(Hérité de Parameter)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(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()

Ainsi, l'objet Parameter effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans l'objet ViewState du contrôle et être persistantes 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 enregistré précédemment pour 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()

Ainsi, l'objet Parameter effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans l'objet ViewState du contrôle et être persistantes entre les demandes de la même page.

(Hérité de Parameter)

S’applique à

Voir aussi