Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

ControlParameter, classe

.NET Framework 4

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

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

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
public class ControlParameter : Parameter

Le type ControlParameter expose les membres suivants.

  Nom Description
Méthode publique ControlParameter() Initialise une nouvelle instance sans nom de la classe ControlParameter.
Méthode protégée ControlParameter(ControlParameter) Initialise une nouvelle instance de la classe ControlParameter avec des valeurs de l'instance spécifiée.
Méthode publique 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.
Méthode publique 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.
Méthode publique 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.
Méthode publique 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.
Début
  Nom Description
Propriété publique ControlID Spécifie le nom du contrôle auquel l'objet ControlParameter crée une liaison.
Propriété publique 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 String.Empty. (Hérité de Parameter.)
Propriété publique DbType Obtient ou définit le type de base de données du paramètre. (Hérité de Parameter.)
Propriété publique 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 est appelée. (Hérité de Parameter.)
Propriété publique 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.)
Propriété protégée IsTrackingViewState Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage. (Hérité de Parameter.)
Propriété publique Name Obtient ou définit le nom du paramètre. (Hérité de Parameter.)
Propriété publique 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.
Propriété publique Size Obtient ou définit la taille du paramètre. (Hérité de Parameter.)
Propriété publique Type Obtient ou définit le type du paramètre. (Hérité de Parameter.)
Propriété protégée 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.)
Début
  Nom Description
Méthode protégée Clone Retourne un doublon de l'instance ControlParameter actuelle. (Substitue Parameter.Clone().)
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée Evaluate Met à jour et retourne la valeur de l'objet ControlParameter. (Substitue Parameter.Evaluate(HttpContext, Control).)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique GetDatabaseType Obtient la valeur DbType qui est équivalente au type CLR de l'instance Parameter actuelle. (Hérité de Parameter.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée LoadViewState Restaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de Parameter.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégée OnParameterChanged Appelle la méthode OnParametersChanged de la collection ParameterCollection qui contient l'objet Parameter. (Hérité de Parameter.)
Méthode protégée 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.)
Méthode protégée SetDirty Marque l'objet Parameter afin que son état soit enregistré dans l'état d'affichage. (Hérité de Parameter.)
Méthode publique ToString Convertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente. (Hérité de Parameter.)
Méthode protégée 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.)
Début
  Nom Description
Implémentation d'interface explicite Méthode privée ICloneable.Clone Retourne un doublon de l'instance de Parameter actuelle. (Hérité de Parameter.)
Implémentation d'interface explicite Propriété privée IStateManager.IsTrackingViewState Infrastructure. Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage. (Hérité de Parameter.)
Implémentation d'interface explicite Méthode privée IStateManager.LoadViewState Infrastructure. Restaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de Parameter.)
Implémentation d'interface explicite Méthode privée IStateManager.SaveViewState Infrastructure. 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.)
Implémentation d'interface explicite Méthode privée IStateManager.TrackViewState Infrastructure. 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.)
Début

Vous pouvez utiliser la classe ControlParameter pour lier la valeur d'une propriété Control, 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 classe ControlParameter fournit deux propriétés en plus de celles héritées de la classe Parameter : ControlID et PropertyName. La propriété ControlID identifie quelle instance de Control vers laquelle créer une liaison et la propriété PropertyName identifie la propriété publique du Control duquel la classe ControlParameter récupère une valeur.

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

C#
VB
Copier 

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

Pris en charge dans : 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ