ParameterCollection.Add Méthode

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.

Ajoute un Parameter objet à la collection.

Surcharges

Nom	Description
Add(Parameter)	Ajoute l’objet spécifié Parameter à la fin de la collection.
Add(String, String)	Crée un Parameter objet portant le nom et la valeur par défaut spécifiés, puis l’ajoute à la fin de la collection.
Add(String, DbType, String)	Crée un Parameter objet portant le nom, le type de base de données et la valeur par défaut spécifiés, puis l’ajoute à la fin de la collection.
Add(String, TypeCode, String)	Crée un Parameter objet portant le nom spécifié, TypeCodeet la valeur par défaut, puis l’ajoute à la fin de la collection.

Add(Parameter)

Ajoute l’objet spécifié Parameter à la fin de la collection.

public:
 int Add(System::Web::UI::WebControls::Parameter ^ parameter);

public int Add(System.Web.UI.WebControls.Parameter parameter);

member this.Add : System.Web.UI.WebControls.Parameter -> int

Public Function Add (parameter As Parameter) As Integer

Paramètres

parameter: Parameter

À Parameter ajouter à la collection.

Retours

Int32

Valeur d’index de l’élément ajouté.

Exemples

L’exemple de code suivant montre comment utiliser un contrôle AccessDataSource et un objet FormParameter pour afficher des informations à partir d’une base de données Microsoft Access dans un contrôle GridView. L’objet FormParameter est ajouté à la collection à l’aide SelectParameters de la Add(Parameter) méthode.

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

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname","LastNameBox");
  formParam.Type=TypeCode.String;
  AccessDataSource1.SelectParameters.Add(formParam);
}

</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:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

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

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </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 Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname","LastNameBox")
  formParam.Type=TypeCode.String
  AccessDataSource1.SelectParameters.Add(formParam)
End Sub ' Page_Load

</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:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

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

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </form>
  </body>
</html>

Remarques

Utilisez la Add(Parameter) méthode pour ajouter un Parameter objet à la fin de la collection. Cette implémentation de la méthode prend l’objet Parameter spécifié par le param paramètre et l’ajoute à la collection.

Voir aussi

S’applique à

Add(String, String)

Crée un Parameter objet portant le nom et la valeur par défaut spécifiés, puis l’ajoute à la fin de la collection.

public:
 int Add(System::String ^ name, System::String ^ value);

public int Add(string name, string value);

member this.Add : string * string -> int

Public Function Add (name As String, value As String) As Integer

Paramètres

name: String

Nom du paramètre.

value: String

Chaîne qui sert de valeur par défaut pour le paramètre.

Retours

Int32

Valeur d’index de l’élément ajouté.

Remarques

Utilisez la Add(String, String) méthode pour créer et ajouter un Parameter objet avec une valeur par défaut à la fin de la collection. Cette implémentation de la méthode crée l’objet Parameter à l’aide du nom et de la valeur par défaut spécifiés par les name paramètres, value respectivement, et l’ajoute à la collection.

Voir aussi

Parameter

S’applique à

Add(String, DbType, String)

Crée un Parameter objet portant le nom, le type de base de données et la valeur par défaut spécifiés, puis l’ajoute à la fin de la collection.

public:
 int Add(System::String ^ name, System::Data::DbType dbType, System::String ^ value);

public int Add(string name, System.Data.DbType dbType, string value);

member this.Add : string * System.Data.DbType * string -> int

Public Function Add (name As String, dbType As DbType, value As String) As Integer

Paramètres

name: String

Nom du paramètre.

dbType: DbType

Type de base de données du paramètre.

value: String

Valeur par défaut du paramètre.

Retours

Int32

Valeur d’index de l’élément ajouté.

Remarques

Cette méthode concerne les types de base de données. Utilisez la méthode pour les Add(String, TypeCode, String) types CLR.

S’applique à

Add(String, TypeCode, String)

Crée un Parameter objet portant le nom spécifié, TypeCodeet la valeur par défaut, puis l’ajoute à la fin de la collection.

public:
 int Add(System::String ^ name, TypeCode type, System::String ^ value);

public int Add(string name, TypeCode type, string value);

member this.Add : string * TypeCode * string -> int

Public Function Add (name As String, type As TypeCode, value As String) As Integer

Paramètres

name: String

Nom du paramètre.

type: TypeCode

Type du paramètre .

value: String

Valeur par défaut du paramètre.

Retours

Int32

Valeur d’index de l’élément ajouté.

Remarques

Utilisez la Add(String, TypeCode, String) méthode pour créer et ajouter un objet fortement typé Parameter avec une valeur par défaut à la fin de la collection. Cette implémentation de la méthode crée l’objet Parameter à l’aide du nom, du type et de la valeur spécifiés par les nametype paramètres, respectivement, et value l’ajoute à la collection.

Voir aussi

Parameter

S’applique à

Commentaires

Cette page a-t-elle été utile ?