Éditeur de collections Parameter, boîte de dialogue
Publication: mars 2016
Vous permet de créer et de configurer des paramètres pour les requêtes SQL, méthodes d'objet métier ou expressions de filtrage associées aux contrôles de source de données ObjectDataSource, SqlDataSource et AccessDataSource. Les objets Parameter sont évalués au moment de l'exécution, pour lier les valeurs des variables qu'ils représentent aux méthodes utilisées par les contrôles de source de données afin d'interagir avec les données. Les objets Parameter sont contenus dans un objet ParameterCollection.
Tâches
Modification de la collection Parameter
La boîte de dialogue Éditeur de collections Parameter s'affiche lorsque vous utilisez la fenêtre Propriétés pour configurer un contrôle ObjectDataSource, SqlDataSource ou AccessDataSource en mode Design.
Sélectionnez le contrôle SqlDataSource ou AccessDataSource dans l'aire de conception, puis sélectionnez la propriété FilterParameters dans la fenêtre Propriétés pour ouvrir la boîte de dialogue Éditeur de collections Parameter. Pour le contrôle ObjectDataSource, sélectionnez les propriétés DeleteParameters, FilterParameters, SelectParameters et UpdateParameters dans la fenêtre Propriétés pour ouvrir la boîte de dialogue Éditeur de collections Parameter.
Attribution de noms à des paramètres
Les instructions ou procédures stockées de la boîte de dialogue Éditeur de collections Parameter peuvent être définies avec des espaces réservés de paramètre. Dans la mesure où plusieurs produits de base de données utilisent des variétés différentes de SQL, la syntaxe de la chaîne SQL dépend du fournisseur ADO.NET actuellement utilisé, identifié par la propriété ProviderName. Si la chaîne SQL est une requête ou une commande paramétrée, l'espace réservé du paramètre dépend également du fournisseur ADO.NET utilisé. Par exemple, si le fournisseur est l'espace de noms System.Data.SqlClient, qui est le fournisseur par défaut pour la classe SqlDataSource, l'espace réservé du paramètre est @parameterName. Toutefois, si le fournisseur a pour valeur l'espace de noms System.Data.Odbc ou System.Data.OleDb, l'espace réservé du paramètre est ?.
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 :
Propriété ConvertEmptyStringToNull.
Propriété DefaultValue.
Propriété Direction.
Propriété Name.
Propriété Size.
Propriété Type.
Éléments de l'interface utilisateur
Paramètres
Affiche les paramètres actuellement présents dans la collection de paramètres.Ajouter un paramètre
Crée un nouveau paramètre dans la collection. Par défaut, ce paramètre est nommé newparameter. Sélectionnez le nom du paramètre pour le modifier.Vous pouvez réordonner les paramètres en cliquant sur les boutons appropriés, comme le montre le tableau suivant.
To
Cliquer sur ce bouton
Déplacer un paramètre vers le haut dans la hiérarchie
Déplacer un paramètre vers le bas dans la hiérarchie
Supprimer un paramètre de la hiérarchie
Source du paramètre
Spécifie les sources de données du paramètre. Chaque source provoque un contrôle Parameter différent dans le ParameterCollection. Les options disponibles sont décrites dans le tableau suivant :Source
Paramètre résultant
Aucun
Contrôle
Cookie
Formulaire
Champ
QueryString
Session
Afficher les propriétés avancées
Affiche les propriétés avancées du paramètre actuellement sélectionné.Propriétés
Définit les propriétés du contrôle Parameter.Masquer les propriétés avancées
Masque les propriétés avancées du paramètre actuellement sélectionné.