Cette documentation est archivée et n’est pas conservée.

ParameterCollection, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente une collection d'objets dérivés de Parameter et Parameter qui sont utilisés par les contrôles de source de données dans les scénarios de liaison de données avancés.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class ParameterCollection : StateManagedCollection
public class ParameterCollection extends StateManagedCollection
public class ParameterCollection extends StateManagedCollection

La classe ParameterCollection représente une collection d'objets Parameter utilisée dans les scénarios de liaison de données avancés avec les contrôles de source de données. Les objets Parameter sont utilisés pour lier les valeurs contenues dans les variables Page locales, les cookies HTTP, les variables de session et d'autres valeurs de contrôles aux contrôles de source de données lors de la récupération, de la mise à jour, de la suppression et de l'insertion de données.

Utilisez la classe ParameterCollection pour gérer par programme un ensemble d'objets Parameter. Vous pouvez ajouter, insérer et supprimer des objets Parameter à l'aide des méthodes appropriées de la classe ParameterCollection. Pour récupérer par programme des objets Parameter à partir d'une collection, utilisez l'une des méthodes suivantes :

  • Utilisez l'indexeur pour obtenir un seul objet Parameter de la collection, par nom ou à l'aide d'une notation de tableau.

  • Utilisez la méthode GetEnumerator pour créer un objet implémentant System.Collections.IEnumerator, pouvant ensuite être utilisé pour obtenir des éléments de la collection.

La propriété Count spécifie le nombre total d'éléments dans la collection et est utilisée pour déterminer la limite supérieure de la collection. Vous pouvez ajouter des éléments dans la collection ou en supprimer à l'aide des méthodes Add, Insert, Remove et RemoveAt.

En fonction de l'implémentation et de la sémantique d'un contrôle de source de données particulier, il est possible que l'ordre dans lequel les paramètres sont stockés dans la collection ParameterCollection soit important. Par exemple, lors de l'utilisation du contrôle SqlDataSource comme source de données ODBC, l'ordre des objets Parameter dans la collection ParameterCollection doit être le même que l'ordre des paramètres dans les requêtes SQL paramétrées que vous utilisez. Toutefois, lors de l'utilisation du contrôle SqlDataSource avec Microsoft SQL Server, l'ordre des objets Parameter n'est pas important.

Le tableau suivant répertorie les différentes classes Parameter et comment elles sont utilisées.

Classe Parameter

Description

Parameter

Classe Parameter de base. Utilisez-la pour créer une liaison avec une variable locale ou toute chaîne statique à l'aide de la propriété DefaultValue.

ControlParameter

Paramètre qui peut être utilisé pour créer une liaison avec une valeur de retour de méthode ou de propriété d'un contrôle.

CookieParameter

Paramètre qui peut être utilisé pour créer une liaison avec la valeur d'un cookie.

FormParameter

Paramètre qui peut être utilisé pour créer une liaison avec un attribut de la page Web Forms en cours.

QueryStringParameter

Paramètre qui peut être utilisé pour créer une liaison avec une valeur passée à une page Web Forms sur une chaîne de requête.

SessionParameter

Paramètre qui peut être utilisé pour créer une liaison avec la valeur d'une variable de session.

ProfileParameter

Paramètre qui peut être utilisé pour créer une liaison avec la valeur d'une propriété de profil ASP.NET.

L'exemple de code suivant montre comment utiliser un contrôle AccessDataSource et un 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 SelectParameters à l'aide de la méthode Add.

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

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

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

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

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

    </FORM>
  </BODY>
</HTML>

<%@Page Language="VJ#" %>
<!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, System.EventArgs e)
    {
        // You can add a FormParameter to the AccessDataSource control's
        // SelectParameters collection programmatically.
        AccessDataSource1.get_SelectParameters().Clear();

        FormParameter formParam = new FormParameter("lastname", "LastNameBox");

        formParam.set_Type(System.TypeCode.String);
        AccessDataSource1.get_SelectParameters().Add(formParam);
    } //Page_Load
</SCRIPT>
<HTML>
  <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>

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

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

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

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

    </form>
  </BODY>
</HTML>

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.Web.UI.StateManagedCollection
    System.Web.UI.WebControls.ParameterCollection

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: