FormParameter Classe

Définition

Lie la valeur d’un champ Form de requête HTTP à un objet de paramètre.Binds the value of an HTTP request Form field to a parameter object.

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
FormParameter

Exemples

L’exemple de code suivant montre comment insérer des données dans une base de SqlDataSource données à l’aide du contrôle et d’une page Web ASP.NET simple.The following code example demonstrates how to insert data into a database using the SqlDataSource control and a simple ASP.NET Web page. Les données actuelles de la table de données sont affichées dans DropDownList le contrôle.The current data in the data table is displayed in the DropDownList control. Vous pouvez ajouter de nouveaux enregistrements en entrant des valeurs TextBox dans les contrôles et en cliquant sur le bouton.You can add new records by entering values in the TextBox controls and clicking the button. Lorsque l’utilisateur clique sur le bouton, les valeurs spécifiées sont insérées dans la DropDownList base de données et la est actualisée.When the button is clicked, the specified values are inserted into the database, and the DropDownList is refreshed.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité.This example has a text box that accepts user input, which is a potential security threat. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.For more information, see Script Exploits Overview.

<%@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 de Form la collection à un paramètre utilisé dans une requête ou une commande paramétrable.You can use the FormParameter class to bind the value of a form variable in the Form collection to a parameter used in a parameterized query or command. Les contrôles qui lient des données au paramètre peuvent lever une exception si FormParameter un est spécifié, mais qu’aucune variable de formulaire correspondante n’est passée.Controls that bind data to the parameter might throw an exception if a FormParameter is specified but no corresponding form variable is passed. Elles peuvent également ne pas afficher de données si la variable de formulaire est passée sans valeur correspondante.They might also display no data if the form variable is passed with no corresponding value. Définissez le DefaultValue pour éviter ces situations, le cas échéant.Set the DefaultValue to avoid these situations where appropriate.

La FormParameter classe fournit la FormField propriété, qui identifie le nom de la variable de formulaire à lier, en plus de ceux hérités de Parameter la classe.The FormParameter class provides the FormField property, which identifies the name of the form variable to bind to, in addition to those inherited from the Parameter class.

Important

Le FormParameter ne valide aucune des valeurs passées par l’élément de formulaire ; il utilise la valeur brute.The FormParameter does not validate the value passed by the form element in any way; it uses the raw value. Dans la plupart des cas, vous pouvez valider la FormParameter valeur de avant qu’elle soit utilisée par un contrôle de source de données en gérant un événement Updating, tel que Deleting l' Selectingévénement, Inserting, ou exposé par le contrôle de source de données que vous utilisez.In most cases you can validate the value of the FormParameter before it is used by a data source control by handling an event, such as the Selecting, Updating, Inserting, or Deleting event exposed by the data source control you are using. Si la valeur du paramètre ne réussit pas vos tests de validation, vous pouvez annuler l’opération de données en Cancel affectant à truela CancelEventArgs propriété de la classe associée la valeur.If the value of the parameter does not pass your validation tests, you can cancel the data operation by setting the Cancel property of the associated CancelEventArgs class to true.

Constructeurs

FormParameter()

Initialise une nouvelle instance sans nom de la classe FormParameter.Initializes a new unnamed instance of the FormParameter class.

FormParameter(FormParameter)

Initialise une nouvelle instance de la classe FormParameter avec les valeurs de l'instance spécifiée par le paramètre original.Initializes a new instance of the FormParameter class with the values of the instance specified by the original parameter.

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.Initializes a new instance of the FormParameter class, using the specified string to identify which form variable field to bind to.

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.Initializes a new named instance of the FormParameter class, using the specified string to identify which form variable field to bind to.

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.Initializes a new named and strongly typed instance of the FormParameter class, using the specified string to identify which form variable to bind to.

Propriétés

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.Gets or sets a value indicating whether the value that the Parameter object is bound to should be converted to null if it is Empty.

(Hérité de Parameter)
DbType

Obtient ou définit le type de base de données du paramètre.Gets or sets the database type of the parameter.

(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.Specifies a default value for the parameter, should the value that the parameter is bound to be uninitialized when the Evaluate(HttpContext, Control) method is called.

(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.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value.

(Hérité de Parameter)
FormField

Obtient ou définit le nom de la variable de formulaire liée au paramètre.Gets or sets the name of the form variable that the parameter binds to.

IsTrackingViewState

Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Hérité de Parameter)
Name

Obtient ou définit le nom du paramètre.Gets or sets the name of the parameter.

(Hérité de Parameter)
Size

Obtient ou définit la taille du paramètre.Gets or sets the size of the parameter.

(Hérité de Parameter)
Type

Obtient ou définit le type du paramètre.Gets or sets the type of the parameter.

(Hérité de Parameter)
ValidateInput

Obtient ou définit une valeur qui indique si l'entrée cliente dans le paramètre est validée.Gets or sets a value that indicates whether the client input in the parameter is validated.

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.Gets a dictionary of state information that allows you to save and restore the view state of a Parameter object across multiple requests for the same page.

(Hérité de Parameter)

Méthodes

Clone()

Retourne un doublon de l'instance de FormParameter actuelle.Returns a duplicate of the current FormParameter instance.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
Evaluate(HttpContext, Control)

Met à jour et retourne la valeur de l'objet FormParameter.Updates and returns the value of the FormParameter object.

GetDatabaseType()

Obtient la valeur DbType qui est équivalente au type CLR de l'instance Parameter actuelle.Gets the DbType value that is equivalent to the CLR type of the current Parameter instance.

(Hérité de Parameter)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Restaure l'état d'affichage enregistré précédemment pour la vue de source de données.Restores the data source view's previously saved view state.

(Hérité de Parameter)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnParameterChanged()

Appelle la méthode OnParametersChanged(EventArgs) de la collection ParameterCollection qui contient l'objet Parameter.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

(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.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Hérité de Parameter)
SetDirty()

Marque l'objet Parameter afin que son état soit enregistré dans l'état d'affichage.Marks the Parameter object so its state will be recorded in view state.

(Hérité de Parameter)
ToString()

Convertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente.Converts the value of this instance to its equivalent string representation.

(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.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Hérité de Parameter)

Implémentations d’interfaces explicites

ICloneable.Clone()

Retourne un doublon de l'instance de Parameter actuelle.Returns a duplicate of the current Parameter instance.

(Hérité de Parameter)
IStateManager.IsTrackingViewState

Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Hérité de Parameter)
IStateManager.LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour la vue de source de données.Restores the data source view's previously saved view state.

(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.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(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.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Hérité de Parameter)

S’applique à

Voir aussi