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

FormParameter, classe

.NET Framework 4

Lie la valeur d'un champ Form de requête HTTP à un objet Parameter.

System.Object
  System.Web.UI.WebControls.Parameter
    System.Web.UI.WebControls.FormParameter

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

Le type FormParameter expose les membres suivants.

  Nom Description
Méthode publique FormParameter() Initialise une nouvelle instance sans nom de la classe FormParameter.
Méthode protégée FormParameter(FormParameter) Initialise une nouvelle instance de la classe FormParameter avec les valeurs de l'instance spécifiée par le paramètre original.
Méthode publique FormParameter(String, String) Initialise une nouvelle instance nommée de la classe FormParameter, à l'aide de la chaîne spécifiée pour identifier le champ de la variable de formulaire à lier.
Méthode publique FormParameter(String, DbType, String) Initialise une nouvelle instance de la classe FormParameter, à l'aide de la chaîne spécifiée pour identifier le champ de la variable de formulaire à lier.
Méthode publique FormParameter(String, TypeCode, String) Initialise une nouvelle instance nommée et fortement typée de la classe FormParameter, à l'aide de la chaîne spécifiée pour identifier la variable de formulaire à lier.
Début
  Nom Description
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é publique FormField Obtient ou définit le nom de la variable de formulaire liée au paramètre.
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 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 de FormParameter 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 FormParameter. (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 FormParameter pour lier la valeur d'une variable de formulaire dans la collection Form à un paramètre utilisé dans une requête ou une commande paramétrée. Contrôles permettant de lier des données à un paramètre susceptible de lever une exception si un FormParameter est spécifié mais qu'aucune variable de formulaire correspondante n'est passée. Ils peuvent également n'afficher aucune donnée si la variable de formulaire est passée sans valeur correspondante. Définissez le DefaultValue afin d'éviter ce type de situation, si approprié.

La classe FormParameter fournit la propriété FormField, qui identifie le nom de la variable de formulaire à lier, outre celles héritées de la classe Parameter.

Remarque importante Important

Le FormParameter ne valide en aucun cas la valeur passée par l'élément de formulaire. Il utilise la valeur brute. Dans la plupart des cas, vous pouvez valider la valeur du FormParameter avant qu'il ne soit utilisé par un contrôle de source de données en gérant un événement, tel que l'événement Selecting, Updating, Inserting ou Deleting exposé par le contrôle de source de données utilisé. Si la valeur du paramètre ne répond pas aux exigences de vos tests de validation, vous pouvez annuler l'opération de données en définissant la propriété Cancel de la classe CancelEventArgs possédant la valeur true.

L'exemple de code suivant montre comment insérer des données dans une base de données à l'aide du contrôle SqlDataSource et d'une simple page Web ASP.NET. Les données actuelles de la table de données s'affichent dans le contrôle DropDownList. Vous pouvez ajouter de nouveaux enregistrements en entrant des valeurs dans les contrôles TextBox et en cliquant sur le bouton. Lorsqu'un clic est effectué sur le bouton, les valeurs spécifiées sont insérées dans la base de données et DropDownList est actualisé.

Note de sécurité Note de sécurité

Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut pas de script ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script.

C#
VB
Copier 

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

<script runat="server">
private void InsertShipper (object source, EventArgs e) {
  SqlDataSource1.Insert();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

      <br /><asp:textbox
           id="CompanyNameBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

      <br /><asp:textbox
           id="PhoneBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

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