ParameterCollection 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.

Représente une collection d’objets dérivés utilisés Parameterpar les contrôles de source de Parameter données dans des scénarios de liaison de données avancés.

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: Object

StateManagedCollection
ParameterCollection

Exemples

L’exemple de code suivant montre comment utiliser un AccessDataSource contrôle et un FormParameter pour afficher des informations à partir d’une base de données Microsoft Access dans un GridView contrôle. L’objet FormParameter est ajouté à la collection à l’aide SelectParameters de la Add 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

La ParameterCollection classe représente une collection d’objets utilisés dans des scénarios de liaison de données avancés avec des contrôles de source de Parameter données. Les Parameter objets sont utilisés pour lier les valeurs contenues par les variables locales Page , les cookies HTTP, les variables de session et les valeurs d’autres 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 ParameterCollection classe pour gérer par programmation un ensemble d’objets Parameter . Vous pouvez ajouter, insérer et supprimer Parameter des objets à l’aide des méthodes appropriées de la ParameterCollection classe. Pour récupérer Parameter des objets d’une collection par programmation, utilisez l’une des méthodes suivantes :

Utilisez l’indexeur pour obtenir un seul Parameter objet de la collection, par nom ou à l’aide de la notation de tableau.
Utilisez la GetEnumerator méthode pour créer un System.Collections.IEnumeratorobjet -implémenté, qui peut ensuite être utilisé pour obtenir des éléments de la collection.

La Count propriété spécifie le nombre total d’éléments de la collection et est utilisée pour déterminer la limite supérieure de la collection. Vous pouvez ajouter et supprimer des éléments de la collection à l’aide des méthodes, et Remove RemoveAt les AddméthodesInsert.

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 ParameterCollection collection peut être important. Par exemple, lorsque vous utilisez le SqlDataSource contrôle comme source de données ODBC, l’ordre des Parameter objets de la ParameterCollection collection doit être identique à l’ordre des paramètres dans les requêtes SQL paramétrables que vous utilisez. Toutefois, lors de l’utilisation du SqlDataSource contrôle avec Microsoft SQL Server, l’ordre des Parameter objets n’est pas important.

Important

Lorsque vous utilisez des contrôles de source de données, les valeurs sont insérées dans des paramètres de commande sans validation, ce qui constitue une menace de sécurité potentielle. 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. Pour plus d’informations, consultez Vue d’ensemble des exploits de script.

Le tableau suivant répertorie les différentes classes de paramètres et la façon dont elles sont utilisées.

Parameter, classe	Description
Parameter	Classe de paramètre de base. Utilisez-la pour établir une liaison à une variable locale ou à une chaîne statique à l’aide de la DefaultValue propriété.
ControlParameter	Paramètre qui peut être utilisé pour établir une liaison à la propriété ou à la valeur de retour de méthode d’un contrôle.
CookieParameter	Paramètre qui peut être utilisé pour établir une liaison à la valeur d’un cookie.
FormParameter	Paramètre qui peut être utilisé pour établir une liaison à un attribut de la page Web Forms actuelle.
QueryStringParameter	Paramètre qui peut être utilisé pour lier une valeur passée à une page Web Forms sur une chaîne de requête.
SessionParameter	Paramètre qui peut être utilisé pour établir une liaison à la valeur d’une variable de session.
ProfileParameter	Paramètre qui peut être utilisé pour établir une liaison à la valeur d’une propriété profile ASP.NET.

Constructeurs

Nom	Description
ParameterCollection()	Initialise la classe à utiliser par une instance de classe héritée. Ce constructeur peut être appelé uniquement par une classe héritée.

Propriétés

Nom	Description
Count	Obtient le nombre d’éléments contenus dans la StateManagedCollection collection. (Hérité de StateManagedCollection)
Item[Int32]	Obtient ou définit l’objet Parameter à l’index spécifié dans la collection.
Item[String]	Obtient ou définit l’objet Parameter avec le nom spécifié dans la collection.

Méthodes

Nom	Description
Add(Parameter)	Ajoute l’objet spécifié Parameter à 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, 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, 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.
Clear()	Supprime tous les éléments de la StateManagedCollection collection. (Hérité de StateManagedCollection)
Contains(Parameter)	Détermine si la ParameterCollection collection contient une valeur spécifique.
CopyTo(Array, Int32)	Copie les éléments de la StateManagedCollection collection dans un tableau, en commençant par un index de tableau particulier. (Hérité de StateManagedCollection)
CopyTo(Parameter[], Int32)	Copie un index spécifié d’un tableau de paramètres dans la collection de paramètres.
CreateKnownType(Int32)	Crée une instance d’un objet par défaut Parameter .
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetEnumerator()	Retourne un itérateur qui itère dans la StateManagedCollection collection. (Hérité de StateManagedCollection)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetKnownTypes()	Obtient un tableau de Parameter types que la ParameterCollection collection peut contenir.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetValues(HttpContext, Control)	Obtient une collection ordonnée de noms d’objets Parameter et leurs valeurs correspondantes actuellement contenues par la collection.
IndexOf(Parameter)	Détermine l’index d’un objet spécifié Parameter dans la ParameterCollection collection.
Insert(Int32, Parameter)	Insère l’objet spécifié Parameter dans la ParameterCollection collection à l’index spécifié.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnClear()	En cas de substitution dans une classe dérivée, effectue un travail supplémentaire avant que la Clear() méthode supprime tous les éléments de la collection. (Hérité de StateManagedCollection)
OnClearComplete()	Effectue des processus personnalisés supplémentaires après avoir désactivé le contenu de la collection.
OnInsert(Int32, Object)	Se produit avant l’appel de la Insert(Int32, Parameter) méthode.
OnInsertComplete(Int32, Object)	Se produit une fois la Insert(Int32, Parameter) méthode terminée.
OnParametersChanged(EventArgs)	Déclenche l’événement ParametersChanged.
OnRemove(Int32, Object)	En cas de substitution dans une classe dérivée, effectue un travail supplémentaire avant que la ou IList.RemoveAt(Int32) la IList.Remove(Object) méthode supprime l’élément spécifié de la collection. (Hérité de StateManagedCollection)
OnRemoveComplete(Int32, Object)	Se produit une fois la Remove(Parameter) méthode terminée.
OnValidate(Object)	Effectue des processus personnalisés supplémentaires lors de la validation d’une valeur.
Remove(Parameter)	Supprime l’objet spécifié Parameter de la ParameterCollection collection.
RemoveAt(Int32)	Supprime l’objet à l’index Parameter spécifié de la ParameterCollection collection.
SetDirty()	Force la sérialisation de l’ensemble StateManagedCollection de la collection dans l’état d’affichage. (Hérité de StateManagedCollection)
SetDirtyObject(Object)	Marque l’objet spécifié Parameter comme ayant changé depuis la dernière charge ou enregistrement à partir de l’état d’affichage.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
UpdateValues(HttpContext, Control)	Itère dans les Parameter objets contenus dans la collection et appelle la `Evaluate` méthode sur chacune d’elles.

Événements

Nom	Description
ParametersChanged	Se produit lorsqu’un ou plusieurs Parameter objets contenus dans la collection changent d’état.

Implémentations d’interfaces explicites

Nom	Description
ICollection.Count	Obtient le nombre d’éléments contenus dans la StateManagedCollection collection. (Hérité de StateManagedCollection)
ICollection.IsSynchronized	Obtient une valeur indiquant si la StateManagedCollection collection est synchronisée (thread safe). Cette méthode retourne `false` dans tous les cas. (Hérité de StateManagedCollection)
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à la StateManagedCollection collection. Cette méthode retourne `null` dans tous les cas. (Hérité de StateManagedCollection)
IEnumerable.GetEnumerator()	Retourne un itérateur qui itère dans la StateManagedCollection collection. (Hérité de StateManagedCollection)
IList.Add(Object)	Ajoute un élément à la StateManagedCollection collection. (Hérité de StateManagedCollection)
IList.Clear()	Supprime tous les éléments de la StateManagedCollection collection. (Hérité de StateManagedCollection)
IList.Contains(Object)	Détermine si la StateManagedCollection collection contient une valeur spécifique. (Hérité de StateManagedCollection)
IList.IndexOf(Object)	Détermine l’index d’un élément spécifié dans la StateManagedCollection collection. (Hérité de StateManagedCollection)
IList.Insert(Int32, Object)	Insère un élément dans la collection à l’index StateManagedCollection spécifié. (Hérité de StateManagedCollection)
IList.IsFixedSize	Obtient une valeur indiquant si la StateManagedCollection collection a une taille fixe. Cette méthode retourne `false` dans tous les cas. (Hérité de StateManagedCollection)
IList.IsReadOnly	Obtient une valeur indiquant si la StateManagedCollection collection est en lecture seule. (Hérité de StateManagedCollection)
IList.Item[Int32]	Obtient l’élément IStateManager à l’index spécifié. (Hérité de StateManagedCollection)
IList.Remove(Object)	Supprime la première occurrence de l’objet spécifié de la StateManagedCollection collection. (Hérité de StateManagedCollection)
IList.RemoveAt(Int32)	Supprime l’élément IStateManager à l’index spécifié. (Hérité de StateManagedCollection)
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si la StateManagedCollection collection enregistre les modifications apportées à son état d’affichage. (Hérité de StateManagedCollection)
IStateManager.LoadViewState(Object)	Restaure l’état d’affichage enregistré précédemment de la StateManagedCollection collection et les IStateManager éléments qu’il contient. (Hérité de StateManagedCollection)
IStateManager.SaveViewState()	Enregistre les modifications apportées à la StateManagedCollection collection et à chaque IStateManager objet qu’elle contient depuis la publication de la page sur le serveur. (Hérité de StateManagedCollection)
IStateManager.TrackViewState()	Provoque la persistance de la StateManagedCollection IStateManager collection et de chacun des objets qu’elle contient pour suivre les modifications apportées à leur état d’affichage afin qu’elles puissent être conservées dans les requêtes pour la même page. (Hérité de StateManagedCollection)

Méthodes d’extension

Nom	Description
AsParallel(IEnumerable)	Active la parallélisation d’une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.
Cast<TResult>(IEnumerable)	Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.

S’applique à

Voir aussi

Commentaires

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

Partager via

ParameterCollection Classe

Définition

Exemples

Remarques

Constructeurs

Propriétés

Méthodes

Événements

Implémentations d’interfaces explicites

Méthodes d’extension

S’applique à

Voir aussi

Commentaires