Comment : configurer les paramètres pour des adaptateurs de données
Mise à jour : novembre 2007
Dans la majorité des cas, les objets Command d'un adaptateur de données (SelectCommand, InsertCommand, UpdateCommand et DeleteCommand) référencent des instructions SQL ou des procédures stockées exigeant des paramètres. Si vous avez utilisé l'Assistant Configuration d'adaptateur de données pour créer l'adaptateur, les paramètres de ces commandes sont automatiquement configurés pour vous. Toutefois, vous pouvez vouloir configurer manuellement les paramètres ou opérer des petites modifications dans la collection de paramètres existante.
.gif "Remarque") Remarque : |
|---|
Dans la version antérieure de Visual Studio, des adaptateurs de données étaient utilisés pour la communication entre applications et bases de données. Même si les adaptateurs de données figurent toujours parmi les principaux composants des .Fournisseurs de données .NET Framework (ADO.NET), les TableAdapters sont des composants générés par le concepteur qui simplifient le processus de déplacement des données entre votre application et une base de données. Pour plus d'informations sur l'utilisation de TableAdapters, consultez Vue d'ensemble de TableAdapter. |
| Conseil : |
|---|
Pour configurer les paramètres après avoir modifié l'instruction SQL d'une commande, vous pouvez choisir l'option Régénérer la collection de paramètres pour cette commande dans le Générateur de requêtes. |
| Remarque : |
|---|
Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Paramètres Visual Studio. |
Pour configurer les paramètres d'un adaptateur de données
Créez un adaptateur de données. Pour plus d'informations, consultez Création d'adaptateurs de données.
Dans le Concepteur de formulaires ou de composants, sélectionnez l'adaptateur de données puis ouvrez la fenêtre Propriétés.
Développez l'objet de commande dont vous voulez configurer les paramètres (par exemple, UpdateCommand), puis dans la propriété Parameters, cliquez sur le bouton de sélection (...) pour ouvrir la fenêtre Éditeur de collections Parameter.
Pour créer un objet de paramètre, cliquez sur Ajouter.
Placez le nouveau paramètre à la position d'index requise dans la collection appropriée en le déplaçant à l'aide des flèches affichées sous Trier.
Pour définir les propriétés de paramètre, sélectionnez le paramètre dans la liste Membres, puis utilisez la grille des propriétés affichée à droite. Le tableau suivant répertorie les propriétés les plus courantes.
Propriété
Description
SourceColumn
Nom de la colonne d'une table de groupe de données dans laquelle sera lue la valeur du paramètre. Cette propriété est utilisée avec des paramètres qui fournissent des valeurs dans une instruction UPDATE, INSERT ou DELETE (ou des procédures stockées équivalentes).
SourceVersion
Si la valeur du paramètre est dérivée par le biais de la propriété SourceColumn, SourceVersion spécifie la version de l'enregistrement du groupe de données à utiliser comme source pour la valeur de paramètre :
Original - Valeur de la colonne lue dans la base de données. Vous pouvez utiliser cette option lorsque vous avez besoin de connaître la valeur d'une colonne avant de la modifier. Tel est le cas lorsque vous modifiez une clé primaire et que vous avez besoin de connaître l'ancienne clé pour retrouver l'enregistrement dans la base de données.
Current - Valeur de la colonne après la mise à jour d'un enregistrement. En règle générale, il s'agit de la valeur à écrire dans la base de données.
Default - Valeur affectée à une colonne si aucune valeur n'est explicitement fournie.
Value
Valeur explicite du paramètre. Cette propriété est plus souvent définie au moment de l'exécution que statiquement, à celui de la création.
La propriété Value prévaut sur la propriété SourceColumn si toutes les deux sont définies.
NamedParameter
Valeur booléenne indiquant si le paramètre correspond à une variable (généralement au format @nom_paramètre) ou à un espace réservé (généralement un point d'interrogation). Si vous travaillez avec un objet SqlConnection et que vous utilisez des paramètres nommés, attribuez à la propriété la valeur true.
DBType, Precision, Scale, Size
Informations sur le type de données natif (dans le magasin de données) de la valeur du paramètre. La valeur du paramètre est convertie à partir du type spécifié ou vers lui.
Direction
Indique si la valeur du paramètre est passée à la commande ou retournée :
Input - Valeur passée à la commande. Il s'agit de la valeur par défaut.
Output - Valeur passée en retour à partir d'une procédure stockée. (Ne s'applique pas aux instructions SQL.)
InputOutput - Valeur passée à une procédure stockée, puis passée en retour, généralement avec une valeur modifiée.
ReturnValue - Valeur de retour explicite. Par défaut, la valeur de retour correspond au premier élément (valeur d'index zéro) figurant dans la collection Parameters.
ParameterName
Nom servant à référencer le paramètre dans la collection (à la place de sa valeur d'index). Bien qu'il ne soit pas requis, le nom de paramètre est recommandé, parce qu'il facilite la maintenance.
Cliquez sur OK pour fermer la fenêtre Éditeur de collection paramètres.
Répétez les étapes 3 à 7 de la procédure pour configurer les paramètres des autres objets de commande.