Partager via


Éditeur de collection Parameters

Mise à jour : novembre 2007

Vous permet de créer et configurer des paramètres (objets OleDbParameter, SqlParameter, OdbcParameter et OracleParameter) associés à une instruction SQL ou à une procédure stockée dans les TableAdapters et les adaptateurs de données.

Modification de la collection Parameters

L'Éditeur de collections Parameters s'affiche lorsque vous utilisez la fenêtre Propriétés pour configurer un TableAdapter dans le Concepteur de DataSet ou lorsque vous utilisez un adaptateur de données sur un formulaire ou un composant.

Sélectionnez un TableAdapter sur la surface du Concepteur de DataSet et sélectionnez la propriété Parameters dans la fenêtre Propriétés pour ouvrir l'Éditeur de collections Parameters.

  1. ouvert le nœud pour les propriétés SelectCommand, UpdateCommand, InsertCommand et DeleteCommand ;

  2. Modifiez la propriété Parameters pour ouvrir l'Éditeur de collections Parameters.

Remarque :

Si vous utilisez des outils de design de données tels que l'Assistant Configuration de TableAdapter ou l'Assistant Configuration d'adaptateur de données pour configurer un adaptateur, les paramètres de l'adaptateur sont automatiquement configurés.

Attribution de noms à des paramètres

Les instructions ou les procédures stockées dans ces commandes peuvent être définies avec les espaces réservés des paramètres.

Si vous utilisez un objet OleDbDataAdapter, une instruction utilise un point d'interrogation comme espace réservé et peut avoir l'aspect suivant :

Select * From Customers Where City = ?

Si vous utilisez un objet SqlDataAdapter, une instruction qui utilise des paramètres nommés peut avoir l'aspect suivant :

Select * From Customers Where City = @City

Si vous utilisez un objet OracleDataAdapter, une instruction qui utilise des paramètres nommés Oracle peut avoir l'aspect suivant :

SELECT * FROM Customers WHERE CustomerID = :pCustomerID
Remarque :

Pour Oracle, lorsque vous utilisez des paramètres nommés dans une instruction SQL ou une procédure stockée, vous devez faire précéder le nom du paramètre de deux-points (:). Cependant, lorsque vous faites référence à un paramètre nommé ailleurs dans votre code (par exemple lorsque vous appelez la méthode Add), ne faites pas précéder le paramètre nommé de deux-points (:). Le fournisseur de données ajoute automatiquement les deux-points.

Ajout de paramètres

La collection Parameters (Parameters, par exemple) pour une commande contient une liste d'objets parameter qui servent à passer des valeurs aux instructions ou aux procédures stockées au moment de l'exécution. Il existe ainsi un objet parameter par valeur de paramètre qui doit être passée à une commande.

L'éditeur est divisé en deux volets. Dans le volet de gauche, vous ajoutez et supprimez des paramètres ; dans le volet de droite, vous définissez les propriétés d'un paramètre individuel, y compris :

  • La propriété ParameterName, avec laquelle vous pouvez faire référence à une table dans le code.

    Remarque :

    La classe SqlDataAdapter exige des paramètres nommés ; dans les objets SqlParameter, le nom doit donc toujours être précédé de « @ ».

  • La propriété SourceColumn, qui identifie l'emplacement, dans un enregistrement de données, d'où provient la valeur du paramètre. Cette valeur est utilisée pendant les mises à jour ; l'adaptateur de données passe la valeur d'une colonne spécifique à la commande de mise à jour.

  • La propriété SourceVersion, qui est utilisée en combinaison avec la propriété SourceColumn. Si un enregistrement a changé dans le groupe de données, plusieurs copies de l'enregistrement sont disponibles, y compris la valeur d'origine (telle qu'elle est lue dans la source de données) et la valeur actuelle (après les modifications). Lorsque vous spécifiez une valeur de colonne à passer en tant que paramètre, vous sélectionnez celle des deux valeurs qui doit être passée. Normalement, la valeur d'origine est utilisée comme paramètre dans une clause WHERE pour identifier l'enregistrement dans la base de données et la valeur actuelle est utilisée dans les clauses SET ou VALUES.

  • La propriété Value, qui est une valeur littérale explicite à passer en tant que paramètre. Cette propriété se substitue à la propriété SourceColumn ; les deux propriétés s'excluent mutuellement.

Pour plus d'informations sur les paramètres, consultez Paramètres des commandes d'adaptateur de données.

Liste des éléments d'interface utilisateur

  • Add
    Crée un nouveau paramètre dans la collection. Par défaut, la table est nommée Parametern, où n correspond à un numéro séquentiel. Vous pouvez la renommer en définissant sa propriété ParameterName dans la grille des propriétés.

    Remarque :

    L'Éditeur de collections OleDbParameter ne vérifie pas si vous créez le nombre de paramètres correct pour la commande, ni s'ils sont du type correct.

    Les paramètres sont mis en correspondance avec les espaces réservés des paramètres dans les instructions ou les commandes par position. Par conséquent, assurez-vous que les paramètres sont ordonnés correctement dans la collection.

  • Remove
    Supprime le paramètre sélectionné de la collection.

Voir aussi

Concepts

Vue d'ensemble de l'affichage des données

Référence

SqlParameter

Autres ressources

TableAdapters

Connexion aux données dans Visual Studio

Préparation de votre application pour recevoir des données

Extraction de données dans votre application

Affichage des données sur des formulaires dans les applications Windows

Modification des données dans votre application

Validation des données

Enregistrement des données