Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ControlParameter classe

 

Date de publication : novembre 2016

Lie la valeur d’une propriété de Control à un objet de paramètre.

Espace de noms:   System.Web.UI.WebControls
Assembly:  System.Web (dans System.Web.dll)

System.Object
  System.Web.UI.WebControls.Parameter
    System.Web.UI.WebControls.ControlParameter

public class ControlParameter : Parameter

NomDescription
System_CAPS_pubmethodControlParameter()

Initialise une nouvelle instance sans nom de la ControlParameter classe.

System_CAPS_protmethodControlParameter(ControlParameter)

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

System_CAPS_pubmethodControlParameter(String, DbType, String, String)

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

System_CAPS_pubmethodControlParameter(String, String)

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

System_CAPS_pubmethodControlParameter(String, String, String)

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

System_CAPS_pubmethodControlParameter(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é spécifié et le nom du contrôle pour identifier le contrôle à lier.

NomDescription
System_CAPS_pubpropertyControlID

Spécifie le nom du contrôle qui le ControlParameter objet crée une liaison.

System_CAPS_pubpropertyConvertEmptyStringToNull

Obtient ou définit une valeur indiquant si la valeur que le Parameter objet est lié doit être convertie à null si elle est String.Empty.(Hérité de Parameter.)

System_CAPS_pubpropertyDbType

Obtient ou définit le type de base de données du paramètre.(Hérité de Parameter.)

System_CAPS_pubpropertyDefaultValue

Spécifie une valeur par défaut pour le paramètre, doit la valeur du paramètre est lié à sans être initialisé quand la Evaluate méthode est appelée.(Hérité de Parameter.)

System_CAPS_pubpropertyDirection

Indique si le Parameter objet est utilisé pour lier une valeur à un contrôle, ou le contrôle peut être utilisé pour modifier la valeur.(Hérité de Parameter.)

System_CAPS_protpropertyIsTrackingViewState

Obtient une valeur indiquant si le Parameter objet enregistre les modifications apportées à son état d’affichage.(Hérité de Parameter.)

System_CAPS_pubpropertyName

Obtient ou définit le nom du paramètre.(Hérité de Parameter.)

System_CAPS_pubpropertyPropertyName

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

System_CAPS_pubpropertySize

Obtient ou définit la taille du paramètre.(Hérité de Parameter.)

System_CAPS_pubpropertyType

Obtient ou définit le type du paramètre.(Hérité de Parameter.)

System_CAPS_protpropertyViewState

Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et restaurer l’état d’affichage d’un Parameter objet entre plusieurs demandes de la même page.(Hérité de Parameter.)

NomDescription
System_CAPS_protmethodClone()

Retourne un doublon de l’utilisateur actuel ControlParameter instance.(Remplace Parameter.Clone().)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodEvaluate(HttpContext, Control)

Met à jour et retourne la valeur de la ControlParameter objet.(Remplace Parameter.Evaluate(HttpContext, Control).)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection.(Hérité de Object.)

System_CAPS_pubmethodGetDatabaseType()

Obtient le DbType valeur équivalente au type CLR de l’utilisateur actuel Parameter instance.(Hérité de Parameter.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodLoadViewState(Object)

Restaure la vue de source de données enregistré précédemment l’état d’affichage.(Hérité de Parameter.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnParameterChanged()

Appels du OnParametersChanged Procédé de la ParameterCollection collection qui contient le Parameter objet.(Hérité de Parameter.)

System_CAPS_protmethodSaveViewState()

Enregistre les modifications apportées à la Parameter état d’affichage de l’objet depuis la publication de la page sur le serveur.(Hérité de Parameter.)

System_CAPS_protmethodSetDirty()

Marque le Parameter donc son état est enregistré dans l’état d’affichage de l’objet.(Hérité de Parameter.)

System_CAPS_pubmethodToString()

Convertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente.(Hérité de Parameter.)

System_CAPS_protmethodTrackViewState()

Provoque la Parameter objet à suivre les modifications apportées à son état d’affichage afin qu’ils puissent être stockées dans le contrôle ViewState objet et être persistantes entre les demandes pour la même page.(Hérité de Parameter.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Retourne un doublon de l’utilisateur actuel Parameter instance.(Hérité de Parameter.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Restaure la vue de source de données enregistré précédemment l’état d’affichage.(Hérité de Parameter.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Enregistre les modifications apportées à la Parameter état d’affichage de l’objet depuis la publication de la page sur le serveur.(Hérité de Parameter.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Provoque la Parameter objet à suivre les modifications apportées à son état d’affichage afin qu’ils puissent être stockées dans le contrôle ViewState objet et être persistantes entre les demandes pour la même page.(Hérité de Parameter.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient une valeur indiquant si le Parameter objet enregistre les modifications apportées à son état d’affichage.(Hérité de Parameter.)

You can use the T:System.Web.UI.WebControls.ControlParameter class to bind the value of a T:System.Web.UI.Control property, such as P:System.Web.UI.WebControls.ListControl.SelectedValue or P:System.Web.UI.WebControls.ListControl.SelectedIndex, to a parameter that is used in a parameterized SQL query, business object method, or filtering expression.

The T:System.Web.UI.WebControls.ControlParameter class provides two properties in addition to those inherited from the T:System.Web.UI.WebControls.Parameter class: P:System.Web.UI.WebControls.ControlParameter.ControlID and P:System.Web.UI.WebControls.ControlParameter.PropertyName. The P:System.Web.UI.WebControls.ControlParameter.ControlID property identifies which T:System.Web.UI.Control instance to bind to and the P:System.Web.UI.WebControls.ControlParameter.PropertyName property identifies the public property of the T:System.Web.UI.Control from which the T:System.Web.UI.WebControls.ControlParameter class retrieves a value.

The following code example demonstrates how to use a T:System.Web.UI.WebControls.ControlParameter object to bind data displayed in a T:System.Web.UI.WebControls.ListBox control to the selected value of a T:System.Web.UI.WebControls.DropDownList control in a declarative scenario. The T:System.Web.UI.WebControls.ControlParameter object is added to the P:System.Web.UI.WebControls.SqlDataSource.SelectParameters collection of the T:System.Web.UI.WebControls.SqlDataSource control on the form, and corresponds to the "@Title" placeholder text in the P:System.Web.UI.WebControls.SqlDataSource.SelectCommand property.

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

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: