ParameterCollection Classe

Définition

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.Represents a collection of Parameter and Parameter-derived objects that are used by data source controls in advanced data-binding scenarios.

public ref class ParameterCollection : System::Web::UI::StateManagedCollection
public class ParameterCollection : System.Web.UI.StateManagedCollection
type ParameterCollection = class
    inherit StateManagedCollection
Public Class ParameterCollection
Inherits StateManagedCollection
Héritage
ParameterCollection

Exemples

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.The following code example demonstrates how to use an AccessDataSource control and a FormParameter to display information from a Microsoft Access database in a GridView control. L’objet FormParameter est ajouté à la collection SelectParameters à l’aide de la méthode Add.The FormParameter object is added to the SelectParameters collection using the Add method.

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

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

La classe ParameterCollection représente une collection d’objets Parameter utilisés dans des scénarios de liaison de données avancés avec des contrôles de source de données.The ParameterCollection class represents a collection of Parameter objects used in advanced data-binding scenarios with data source controls. Les objets Parameter sont utilisés pour lier les valeurs contenues par les variables locales Page, 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.The Parameter objects are used to bind the values contained by local Page variables, HTTP cookies, session variables, and other controls' values to data source controls when retrieving, updating, deleting, and inserting data.

Utilisez la classe ParameterCollection pour gérer par programmation un ensemble d’objets Parameter.Use the ParameterCollection class to programmatically manage a set of Parameter objects. Vous pouvez ajouter, insérer et supprimer des objets Parameter à l’aide des méthodes appropriées de la classe ParameterCollection.You can add, insert, and remove Parameter objects using the appropriate methods of the ParameterCollection class. Pour récupérer des objets Parameter par programme à partir d’une collection, utilisez l’une des méthodes suivantes :To programmatically retrieve Parameter objects from a collection, use one of following methods:

  • Utilisez l’indexeur pour obtenir un seul objet Parameter de la collection, par nom ou à l’aide de la notation de tableau.Use the indexer to get a single Parameter object from the collection, by name or using array notation.

  • Utilisez la méthode GetEnumerator pour créer un objet @no__t implémenté à 1 -1, qui peut ensuite être utilisé pour obtenir des éléments de la collection.Use the GetEnumerator method to create a System.Collections.IEnumerator-implemented object, which can then be used to get items from the 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.The Count property specifies the total number of items in the collection, and is used to determine the upper bound of the collection. Vous pouvez ajouter et supprimer des éléments de la collection à l’aide des méthodes Add, Insert, Remove et RemoveAt.You can add and remove items from the collection by using the Add, Insert, Remove, and RemoveAt methods.

En fonction de l’implémentation et de la sémantique d’un contrôle de source de données particulier, l’ordre dans lequel les paramètres sont stockés dans la collection ParameterCollection peut être important.Depending on the implementation and the semantics of a particular data source control, the order in which the parameters are stored in the ParameterCollection collection might be important. Par exemple, lorsque vous utilisez le 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étrables que vous utilisez.For example, when using the SqlDataSource control as an ODBC data source, the order of the Parameter objects in the ParameterCollection collection must be the same as the order of the parameters in the parameterized SQL queries you use. Toutefois, lors de l’utilisation du contrôle SqlDataSource avec Microsoft SQL Server, l’ordre des objets Parameter n’est pas important.However, when using the SqlDataSource control with Microsoft SQL Server, the order of the Parameter objects are not important.

Important

Lorsque vous utilisez des contrôles de source de données, les valeurs sont insérées dans les paramètres de commande sans validation, ce qui constitue une menace potentielle pour la sécurité.When you use data source controls, values are inserted into command parameters without validation, which is a potential security threat. Utilisez un événement dans le contrôle de source de données pour valider les valeurs des paramètres avant l’exécution de la commande.Use an event in the data source control to validate parameter values before the command is executed. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.For more information, see Script Exploits Overview.

Le tableau suivant répertorie les différentes classes de paramètres et la façon dont elles sont utilisées.The following table lists the different parameter classes and how they are used.

Classe de paramètreParameter Class DescriptionDescription
Parameter Classe de paramètres de base.The base parameter class. Utilisez-le pour effectuer une liaison à une variable locale ou à toute chaîne statique à l’aide de la propriété DefaultValue.Use it to bind to a local variable or any static string using the DefaultValue property.
ControlParameter Paramètre qui peut être utilisé pour établir une liaison à la valeur de retour de la méthode ou de la propriété d’un contrôle.A parameter that can be used to bind to a control's property or method return value.
CookieParameter Paramètre qui peut être utilisé pour établir une liaison à la valeur d’un cookie.A parameter that can be used to bind to the value of a cookie.
FormParameter Paramètre qui peut être utilisé pour effectuer une liaison à un attribut de la page de Web Forms actuelle.A parameter that can be used to bind to an attribute of the current Web Forms page.
QueryStringParameter Paramètre qui peut être utilisé pour établir une liaison à une valeur passée à une page de Web Forms sur une chaîne de requête.A parameter that can be used to bind to a value passed to a Web Forms page on a query string.
SessionParameter Paramètre qui peut être utilisé pour établir une liaison avec la valeur d’une variable de session.A parameter that can be used to bind to the value of a session variable.
ProfileParameter Paramètre qui peut être utilisé pour établir une liaison avec la valeur d’une propriété de profil ASP.NET.A parameter that can be used to bind to the value of an ASP.NET Profile property.

Constructeurs

ParameterCollection()

Initialise la classe pour qu'elle soit utilisée par une instance de la classe héritée.Initializes the class for use by an inherited class instance. Ce constructeur peut être appelé uniquement par une classe héritée.This constructor can be called only by an inherited class.

Propriétés

Count

Obtient le nombre d'éléments contenus dans la collection StateManagedCollection.Gets the number of elements contained in the StateManagedCollection collection.

(Hérité de StateManagedCollection)
Item[Int32]

Obtient ou définit l'objet Parameter à l'index spécifié dans la collection.Gets or sets the Parameter object at the specified index in the collection.

Item[String]

Obtient ou définit l'objet Parameter portant le nom spécifié dans la collection.Gets or sets the Parameter object with the specified name in the collection.

Méthodes

Add(Parameter)

Ajoute l'objet Parameter spécifié à la fin de la collection.Appends the specified Parameter object to the end of the collection.

Add(String, DbType, String)

Crée un objet Parameter avec 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.Creates a Parameter object with the specified name, database type, and default value, and adds it to the end of the collection.

Add(String, String)

Crée un objet Parameter avec le nom spécifié et la valeur par défaut et l'ajoute à la fin de la collection.Creates a Parameter object with the specified name and default value, and appends it to the end of the collection.

Add(String, TypeCode, String)

Crée un objet Parameter avec le nom spécifié, TypeCode et la valeur par défaut et l'ajoute à la fin de la collection.Creates a Parameter object with the specified name, TypeCode, and default value, and appends it to the end of the collection.

Clear()

Supprime tous les éléments de la collection StateManagedCollection.Removes all items from the StateManagedCollection collection.

(Hérité de StateManagedCollection)
Contains(Parameter)

Détermine si la collection ParameterCollection contient une valeur spécifique.Determines whether the ParameterCollection collection contains a specific value.

CopyTo(Array, Int32)

Copie les éléments de la collection StateManagedCollection dans un tableau, en commençant au niveau d'un index de tableau particulier.Copies the elements of the StateManagedCollection collection to an array, starting at a particular array index.

(Hérité de StateManagedCollection)
CopyTo(Parameter[], Int32)

Copie l'index spécifié d'un tableau de paramètres dans la collection de paramètres.Copies a specified index of a parameter array to the parameter collection.

CreateKnownType(Int32)

Crée une instance d'un objet Parameter par défaut.Creates an instance of a default Parameter object.

Equals(Object)

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

(Hérité de Object)
GetEnumerator()

Retourne un itérateur qui itère au sein de la collection StateManagedCollection.Returns an iterator that iterates through the StateManagedCollection collection.

(Hérité de StateManagedCollection)
GetHashCode()

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

(Hérité de Object)
GetKnownTypes()

Obtient un tableau des types Parameter que la collection ParameterCollection peut contenir.Gets an array of Parameter types that the ParameterCollection collection can contain.

GetType()

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

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

Obtient une collection triée de noms d'objets Parameter et leurs valeurs correspondantes actuellement contenus dans la collection.Gets an ordered collection of Parameter object names and their corresponding values currently contained by the collection.

IndexOf(Parameter)

Détermine l'index d'un objet Parameter spécifié dans la collection ParameterCollection.Determines the index of a specified Parameter object in the ParameterCollection collection.

Insert(Int32, Parameter)

Insère l'objet Parameter spécifié dans la collection ParameterCollection à l'index spécifié.Inserts the specified Parameter object into the ParameterCollection collection at the specified index.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnClear()

En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire avant que la méthode Clear() supprime tous les éléments de la collection.When overridden in a derived class, performs additional work before the Clear() method removes all items from the collection.

(Hérité de StateManagedCollection)
OnClearComplete()

Exécute des processus personnalisés supplémentaires après l'effacement du contenu de la collection.Performs additional custom processes after clearing the contents of the collection.

OnInsert(Int32, Object)

Se produit avant que la méthode Insert(Int32, Parameter) soit appelée.Occurs before the Insert(Int32, Parameter) method is called.

OnInsertComplete(Int32, Object)

Se produit après que la méthode Insert(Int32, Parameter) est terminée.Occurs after the Insert(Int32, Parameter) method completes.

OnParametersChanged(EventArgs)

Déclenche l'événement ParametersChanged.Raises the ParametersChanged event.

OnRemove(Int32, Object)

En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire avant que la méthode IList.Remove(Object) ou IList.RemoveAt(Int32) supprime l'élément spécifié de la collection.When overridden in a derived class, performs additional work before the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection.

(Hérité de StateManagedCollection)
OnRemoveComplete(Int32, Object)

Se produit après que la méthode Remove(Parameter) est terminée.Occurs after the Remove(Parameter) method completes.

OnValidate(Object)

Exécute des processus personnalisés supplémentaires lors de la validation d'une valeur.Performs additional custom processes when validating a value.

Remove(Parameter)

Supprime de la collection Parameter l'objet ParameterCollection spécifié.Removes the specified Parameter object from the ParameterCollection collection.

RemoveAt(Int32)

Supprime l'objet Parameter de la collection ParameterCollection à l'index spécifié.Removes the Parameter object at the specified index from the ParameterCollection collection.

SetDirty()

Force la sérialisation de l'intégralité de la collection StateManagedCollection dans l'état d'affichage.Forces the entire StateManagedCollection collection to be serialized into view state.

(Hérité de StateManagedCollection)
SetDirtyObject(Object)

Marque l'objet Parameter spécifié comme modifié depuis son dernier chargement ou enregistrement à partir de l'état d'affichage.Marks the specified Parameter object as having changed since the last load or save from view state.

ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

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

Itère au sein des objets Parameter contenus dans la collection et appelle la méthode Evaluate sur chacun des objets.Iterates through the Parameter objects contained by the collection, and calls the Evaluate method on each one.

Événements

ParametersChanged

Se produit lorsque l'état d'un ou de plusieurs objets Parameter contenus dans la collection est modifié.Occurs when one or more Parameter objects contained by the collection changes state.

Implémentations d’interfaces explicites

ICollection.Count

Obtient le nombre d'éléments contenus dans la collection StateManagedCollection.Gets the number of elements contained in the StateManagedCollection collection.

(Hérité de StateManagedCollection)
ICollection.IsSynchronized

Obtient une valeur indiquant si la collection StateManagedCollection est synchronisée (thread-safe).Gets a value indicating whether the StateManagedCollection collection is synchronized (thread safe). Cette méthode retourne false dans tous les cas.This method returns false in all cases.

(Hérité de StateManagedCollection)
ICollection.SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l'accès à la collection StateManagedCollection .Gets an object that can be used to synchronize access to the StateManagedCollection collection. Cette méthode retourne null dans tous les cas.This method returns null in all cases.

(Hérité de StateManagedCollection)
IEnumerable.GetEnumerator()

Retourne un itérateur qui itère au sein de la collection StateManagedCollection.Returns an iterator that iterates through the StateManagedCollection collection.

(Hérité de StateManagedCollection)
IList.Add(Object)

Ajoute un élément à la collection StateManagedCollection.Adds an item to the StateManagedCollection collection.

(Hérité de StateManagedCollection)
IList.Clear()

Supprime tous les éléments de la collection StateManagedCollection.Removes all items from the StateManagedCollection collection.

(Hérité de StateManagedCollection)
IList.Contains(Object)

Détermine si la collection StateManagedCollection contient une valeur spécifique.Determines whether the StateManagedCollection collection contains a specific value.

(Hérité de StateManagedCollection)
IList.IndexOf(Object)

Détermine l'index d'un élément spécifié de la collection StateManagedCollection.Determines the index of a specified item in the StateManagedCollection collection.

(Hérité de StateManagedCollection)
IList.Insert(Int32, Object)

Insère un élément dans la collection StateManagedCollection au niveau de l'index spécifié.Inserts an item into the StateManagedCollection collection at the specified index.

(Hérité de StateManagedCollection)
IList.IsFixedSize

Obtient une valeur indiquant si la collection StateManagedCollection est de taille fixe.Gets a value indicating whether the StateManagedCollection collection has a fixed size. Cette méthode retourne false dans tous les cas.This method returns false in all cases.

(Hérité de StateManagedCollection)
IList.IsReadOnly

Obtient une valeur indiquant si la collection StateManagedCollection est en lecture seule.Gets a value indicating whether the StateManagedCollection collection is read-only.

(Hérité de StateManagedCollection)
IList.Item[Int32]

Obtient l'élément IStateManager au niveau de l'index spécifié.Gets the IStateManager element at the specified index.

(Hérité de StateManagedCollection)
IList.Remove(Object)

Supprime la première occurrence de l'objet spécifié dans la collection StateManagedCollection.Removes the first occurrence of the specified object from the StateManagedCollection collection.

(Hérité de StateManagedCollection)
IList.RemoveAt(Int32)

Supprime l'élément IStateManager au niveau de l'index spécifié.Removes the IStateManager element at the specified index.

(Hérité de StateManagedCollection)
IStateManager.IsTrackingViewState

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

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

Restaure l'état d'affichage précédemment enregistré de la collection StateManagedCollection et les éléments IStateManager qu'elle contient.Restores the previously saved view state of the StateManagedCollection collection and the IStateManager items it contains.

(Hérité de StateManagedCollection)
IStateManager.SaveViewState()

Enregistre les modifications apportées à la collection StateManagedCollection et à chaque objet IStateManager qu'elle contient, depuis la publication de la page sur le serveur.Saves the changes to the StateManagedCollection collection and each IStateManager object it contains since the time the page was posted back to the server.

(Hérité de StateManagedCollection)
IStateManager.TrackViewState()

Commande à la collection StateManagedCollection et à chacun des objets IStateManager qu'elle contient de procéder au suivi des modifications apportées à leur état d'affichage afin qu'ils puissent être rendus persistants au fil des requêtes d'une même page.Causes the StateManagedCollection collection and each of the IStateManager objects it contains to track changes to their view state so they can be persisted across requests for the same page.

(Hérité de StateManagedCollection)

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi