Éditeur de commandes et de paramètres, boîte de dialogue

Publication: avril 2016

La boîte de dialogue Éditeur de commandes et de paramètres vous permet de créer et de configurer des paramètres pour les requêtes SQL associées aux contrôles de source de données 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

• How To: Secure Connection Strings when Using Data Source Controls

Modification de la collection de commandes et de paramètres

La boîte de dialogue Éditeur de commandes et de paramètres s'affiche lorsque vous utilisez la fenêtre Propriétés pour configurer un contrôle SqlDataSource ou AccessDataSource en mode Design. Sélectionnez le contrôle SqlDataSource ou AccessDataSource sur l'aire de conception, puis sélectionnez la propriété DeleteQuery, InsertQuery, SelectQuery ou UpdateQuery dans la fenêtre Propriétés pour ouvrir la boîte de dialogue Éditeur de commandes et de paramètres.

Attribution de noms à des paramètres

Les instructions ou procédures stockées de la boîte de dialogue Éditeur de commandes et de paramètres 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.

La partie supérieure de l'éditeur affiche la commande de suppression, d'insertion, de sélection ou de mise à jour. La partie inférieure de l'éditeur est divisée 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, notamment :

• Propriété ConvertEmptyStringToNull.

• Propriété DefaultValue.

• Propriété Direction.

• Propriété Name.

• Propriété Size.

• Propriété Type.

Éléments de l'interface utilisateur

• Commande DELETE ou commande INSERT ou commande SELECT ou commande UPDATE
  Affiche la commande en cours. Le type de commande indiqué dépend de la propriété sélectionnée dans la fenêtre Propriétés.

• Actualiser les paramètres
  Ajoute les paramètres définis dans la commande SQL à la section Paramètres de la boîte de dialogue. Un clic sur le bouton Actualiser les paramètres ne supprime pas les paramètres qui apparaissent dans la section Paramètres mais qui ne sont pas utilisés dans la commande SQL.

• Générateur de requêtes
  Affiche la boîte de dialogue Générateur de requêtes. Pour plus d'informations, consultez Query and View Designer Tools.

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

• Afficher les propriétés avancées
  Affiche les propriétés avancées du paramètre actuellement sélectionné.

• Masquer les propriétés avancées
  Masque les propriétés avancées du paramètre actuellement sélectionné.

• Ordre des paramètres
  Définit l'ordre dans lequel les paramètres sont répertoriés. 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 entraîne un contrôle Parameter différent dans le ParameterCollection. Les choix sont les suivants :

  Source	Paramètre résultant
  Aucun	Parameter
  Contrôle	ControlParameter
  Cookie	CookieParameter
  Formulaire	FormParameter
  Champ	ProfileParameter
  QueryString	QueryStringParameter
  Session	SessionParameter

Voir aussi

Ajouter une clause WHERE, boîte de dialogue - SqlDataSource
Query and View Designer Tools