FormParameter 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’un champ de requête Form HTTP à un objet de paramètre.

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

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

type FormParameter = class
    inherit Parameter

Public Class FormParameter
Inherits Parameter

Héritage: Object

Parameter
FormParameter

Exemples

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

Important

Cet exemple contient une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits de script.

<%@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>

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

<script runat="server">
Private Sub InsertShipper (ByVal Source As Object, ByVal e As EventArgs)
  SqlDataSource1.Insert()
End Sub ' InsertShipper
</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>

Remarques

Vous pouvez utiliser la FormParameter classe pour lier la valeur d’une variable de formulaire dans la Form collection à un paramètre utilisé dans une requête ou une commande paramétrable. Les contrôles qui lient des données au paramètre peuvent lever une exception si une FormParameter variable de formulaire correspondante n’est pas passée. Ils peuvent également afficher aucune donnée si la variable de formulaire est passée sans valeur correspondante. Définissez la DefaultValue valeur pour éviter ces situations, le cas échéant.

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

Important

La FormParameter valeur n’est pas validée par l’élément de formulaire d’une manière quelconque ; elle utilise la valeur brute. Dans la plupart des cas, vous pouvez valider la valeur du contrôle de source de FormParameter données avant qu’elle soit utilisée par un contrôle de source de données en gérant un événement, tel que le Selecting, Updatingou InsertingDeleting l’événement exposé par le contrôle de source de données que vous utilisez. Si la valeur du paramètre ne passe pas vos tests de validation, vous pouvez annuler l’opération de données en définissant la Cancel propriété de la classe trueassociée CancelEventArgs sur .

Constructeurs

Nom	Description
FormParameter()	Initialise une nouvelle instance sans nom de la FormParameter classe.
FormParameter(FormParameter)	Initialise une nouvelle instance de la FormParameter classe avec les valeurs de l’instance spécifiée par le `original` paramètre.
FormParameter(String, DbType, String)	Initialise une nouvelle instance de la classe à l’aide de la FormParameter chaîne spécifiée pour identifier le champ de variable de formulaire à lier.
FormParameter(String, String)	Initialise une nouvelle instance nommée de la classe à l’aide de la FormParameter chaîne spécifiée pour identifier le champ de variable de formulaire à lier.
FormParameter(String, TypeCode, String)	Initialise une nouvelle instance nommée et fortement typée de la classe, à l’aide de la FormParameter chaîne spécifiée pour identifier la variable de formulaire à lier.

Propriétés

Nom	Description
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)
FormField	Obtient ou définit le nom de la variable de formulaire à laquelle le paramètre est lié.
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)
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)
ValidateInput	Obtient ou définit une valeur qui indique si l’entrée du client dans le paramètre est validée.
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 FormParameter .
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 FormParameter .
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 ?

Partager via

FormParameter Classe

Définition

Exemples

Remarques

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

Commentaires