Configurer la source de données, boîte de dialogue - SqlDataSource

Article
08/21/2008

Mise à jour : novembre 2007

La boîte de dialogue Configurer la source de données - SqlDataSource vous aide à configurer une source de données SQL lorsque vous souhaitez afficher des données relationnelles dans un contrôle serveur Web ASP.NET qui prend en charge la liaison de données. Le titre de la boîte de dialogue change en fonction de l'ID du contrôle de source de données.

Les données relationnelles incluent des bases de données Microsoft SQL Server, des bases de données Oracle, des sources de données OLE DB ou des sources de données ODBC (Open Database Connectivity).

Note de sécurité :
Si possible, connectez-vous à une instance de SQL Server à l'aide de la sécurité intégrée de Windows au lieu d'utiliser un nom d'utilisateur et un mot de passe explicites. Cela permet d'éviter que votre chaîne de connexion soit compromise et que votre ID d'utilisateur et votre mot de passe soient accessibles. Pour plus d'informations, consultez la section "Sécurisation de l'accès à une source de données" dans Sécurisation de l'accès aux données.

Si possible, connectez-vous à une instance de SQL Server à l'aide de la sécurité intégrée de Windows au lieu d'utiliser un nom d'utilisateur et un mot de passe explicites. Cela permet d'éviter que votre chaîne de connexion soit compromise et que votre ID d'utilisateur et votre mot de passe soient accessibles. Pour plus d'informations, consultez la section "Sécurisation de l'accès à une source de données" dans Sécurisation de l'accès aux données.

Les contrôles serveur Web qui prennent en charge la liaison de données sont entre autres les suivants :

BulletedList	DetailsView	GridView	RadioButtonList
CheckBoxList	DropDownList	ListBox	Repeater
DataList	FormView	Menu	TreeView

Pour accéder à cette boîte de dialogue à partir d'un contrôle serveur Web ASP.NET

Dans Visual Web Developer, ouvrez une page ASPX.
Basculez en mode Design.
À partir de la Boîte à outils, faites glisser l'un des contrôles de la liste précédente sur la page. Par exemple, à partir du groupe Standard de la Boîte à outils, faites glisser un contrôle GridView sur la page.
Cliquez avec le bouton droit sur le contrôle, puis cliquez sur Afficher la balise active.

Dans la fenêtre de tâches qui s'affiche, dans la liste déroulante Choisir la source de données, sélectionnez <Nouvelle source de données…>.

Remarque :
Certains contrôles vous permettent uniquement de cliquer sur Choisir la source de données, après quoi vous sélectionnez <Nouvelle source de données...> dans la liste déroulante Sélectionnez une source de données.

L'Assistant Configuration de source de données s'ouvre.

Sous À partir d'où l'application obtiendra-t-elle les données ?, cliquez sur Base de données.
Dans la zone Spécifiez un ID pour la source de données, tapez un ID de source de données.

L'ID par défaut est SqlDataSource1.
Cliquez sur OK.

Un contrôle SqlDataSource est créé automatiquement sur votre page et la fenêtre Configurer la source de données - SqlDataSource1 s'ouvre.

Pour accéder directement à cette boîte de dialogue à partir d'un contrôle SqlDataSource

Dans Visual Web Developer, ouvrez une page ASPX.
Basculez en mode Design.
À partir du groupe Données de la Boîte à outils, faites glisser un contrôle SqlDataSource sur la page.
Dans la fenêtre de tâches, cliquez sur Configurer la source de données.

La fenêtre Configurer la source de données - SqlDataSource1 s'ouvre.

Après avoir configuré le contrôle SqlDataSource, vous pouvez le lier à l'un des contrôles serveur Web dans la liste ci-dessus en spécifiant l'ID de source de données dans la liste déroulante Choisir la source de données ou dans la propriété DataSourceID du contrôle serveur Web.

Pour plus d'informations sur la liaison de données, consultez Vue d'ensemble de l'accès aux données ASP.NET ou les rubriques orientées tâche suivantes.

Tâches

Comment : se connecter à une base de données SQL Server à l'aide du contrôle SqlDataSource (Visual Studio)

Comment : établir une connexion à une base de données Access à l'aide du contrôle SqlDataSource (Visual Studio)

Comment : établir une connexion à une base de données ODBC à l'aide du contrôle SqlDataSource (Visual Studio)

Comment : établir une connexion à une base de données Oracle à l'aide du contrôle SqlDataSource (Visual Studio)

Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual Studio

Comment : sécuriser des chaînes de connexion lors de l'utilisation de contrôles de source de données

Comment : établir une liaison vers les données d'un contrôle basé sur des modèles

Éléments d'interface

Quelle connexion de données votre application doit-elle utiliser pour établir une connexion à la base de données ?
Cet élément apparaît dans l'étape Choisir votre connexion de données de l'Assistant.

Spécifie la connexion à utiliser pour votre base de données. Vous pouvez sélectionner la connexion dans une liste de connexions ou de bases de données existantes, ou vous pouvez cliquer sur Nouvelle connexion pour ouvrir l'Assistant Choisir la source de données.

Dans l'Assistant Choisir la source de données, vous pouvez sélectionner un type et un fournisseur de source de données, et construire une chaîne de connexion dans la fenêtre Ajouter une connexion. Vous pouvez éventuellement choisir d'enregistrer votre chaîne de connexion stockée dans votre fichier Web.config.

Note de sécurité :
Ne stockez pas de chaînes de connexion dans une page, ou comme texte brut dans le fichier Web.config. Pour plus d'informations, consultez la section "Chaînes de connexion" dans Sécurisation de l'accès aux données.

Comment souhaitez-vous récupérer les données de votre base de données ?
Cet élément apparaît dans l'étape Configurer l'instruction Select de l'Assistant.

Spécifie une instruction Select à utiliser lors de l'obtention de données de la base de données. Vous pouvez choisir parmi les options suivantes :
- Spécifier une instruction SQL personnalisée ou une procédure stockée
  
  Cliquez sur Suivant pour générer une instruction SQL personnalisée ou sélectionner une procédure stockée si l'une d'elles est configurée pour votre site Web. Le bouton Générateur de requête fournit une interface utilisateur pour créer l'instruction SELECT. Vous pouvez tester votre requête après avoir cliqué sur Suivant.
- Spécifier les colonnes d'une table ou d'une vue
  
  Sélectionnez le nom de table et les colonnes de données à obtenir. Vous pouvez définir plus précisément votre instruction Select à l'aide des boutons WHERE, ORDER BY et Options avancées. L'instruction SELECT que vous avez générée est visible sous Instruction SELECT. Vous pouvez tester votre requête après avoir cliqué sur Suivant.