Contrôle AccessDataSource dans ASP.NET2.0

Auteur：Eve Cole Date de mise à jour：2009-06-30 16:37:44

ASP.NET 2.0 inclut le contrôle AccessDataSource, qui est utilisé pour extraire les données de la base de données Access vers les pages ASP.NET 2.0 (.aspx). Les propriétés de ce contrôle sont très simples. L'attribut le plus important d'AccessDataSource est l'attribut DataFile, qui est utilisé pour pointer vers le chemin du fichier MDB sur le disque dur. Les autres propriétés appartenant à AccessDataSource incluent SelectCommand, qui est utilisée pour définir une instruction qui affiche l'ensemble de résultats (tables et colonnes) qui doit être renvoyé. SelectCommand doit être défini à l'aide de la syntaxe SQL.

Dans VWD, il existe deux manières d'ajouter le contrôle AccessDataSource à la page. Si le fichier MDB est ajouté à l'explorateur de base de données comme dans l'exemple précédent, les noms de colonnes peuvent être glissés et déposés sur la page, et VWD créera automatiquement des contrôles AccessDataSource et des GridViews pour afficher les données. Si vous ne souhaitez pas utiliser GridView ou souhaitez personnaliser le contrôle, vous pouvez simplement ajouter le contrôle AccessDataSource à partir de la boîte à outils et l'installer via l'assistant de configuration. L'assistant vous invitera à rechercher le fichier de données et vous permettra de spécifier une SelectCommand en sélectionnant des colonnes dans la table de base de données. Si vous accédez à la page en dehors de VWD, vous pouvez la saisir comme suit :

<asp:AccessDataSource>
ID="MonNomSource"
Runat="serveur"
DataFile="MonNomMDB.mdb"
SelectCommand="SELECT MyField1, MyField2 FROM MyTable">
＜/asp:AccessDataSource＞

La fonctionnalité qui doit être mentionnée à nouveau est simple. Tout ce que vous devez fournir est un ID, un nom de fichier MDB et une SelectCommand.

Cet article concerne les contrôles de source de données, mais rappelez-vous que les contrôles de source de données ne rendent rien visible sur la page. Ainsi, pour vous donner un moyen visuel de tester le contrôle de source de données, le prochain « Try It Away » couvrira les étapes de base de l'utilisation du contrôle GridView (évolué du contrôle DataGrid ASP.NET version 1) pour afficher les données dans un tableau. Veuillez noter que ce chapitre ne se concentre pas sur la configuration et la personnalisation de GridView. Dans ce cas, l'accent est mis sur le contrôle de la source de données. Plus loin dans le chapitre 5, le contrôle GridView sera étudié plus en détail.

Essayez n°2 – Connectez-vous à MDB et affichez les données avec GridView

Dans l'exemple de cet article, les informations sur les produits vendus seront affichées via Northwind sur la page.

(1) Démarrez l'éditeur de page et accédez à C:WebsitesBegAspNet2Dbch02.

(2) Ajoutez une page nommée TIO-ch02-2-DisplayAccessData à partir du modèle de formulaire Web. Cliquez sur l'étiquette ci-dessous pour passer en mode Création.

(3) En haut de la page, saisissez un titre tel que « Démo de connexion à la source de données MDB » et mettez le même texte dans le titre de la page. Bien que cette étape ne soit pas abordée dans chaque exercice, nous vous recommandons d'inclure un titre et un texte HTML sur chaque page afin que la page que vous consultez ne soit pas perdue.

<html>
＜tête＞
＜titre＞TIO ch02-1 Afficher les données MDB＜/titre＞
＜tête＞
<corps>
＜h3＞ch02 TIO 2 Démonstration de connexion à une source MDB ＜/h3＞
<corps>
＜/html＞

(4) Affichez la boîte à outils (Menu : Affichage|boîte à outils ou tapez Ctrl+Alt+X) et développez le panneau Données de la boîte à outils.

(5) Faites glisser un contrôle AccessDataSource vers la page.

(6) Le panneau de tâches pratique du contrôle devrait apparaître automatiquement. Si le panneau n'apparaît pas automatiquement, vous pouvez sélectionner la nouvelle source de données et cliquer sur la petite flèche en haut à droite pour ouvrir le panneau de tâches pratique. Cliquez sur Configurer la source de données.

(7) À l'étape Choisir une base de données, cliquez sur le bouton Parcourir et sélectionnez C:WebsitesBegAspNet 2DbApp_DataNorthwind.mdb, et notez que le concepteur convertit la description du fichier en une référence relative, c'est-à-dire en utilisant le symbole (~) pour représenter le site dans le répertoire racine.

(8) Dans la boîte de dialogue Configurer l'instruction Select, sélectionnez l'option Spécifier les colonnes et sélectionnez la table Produits. Cliquez sur l'astérisque pour sélectionner toutes les colonnes. Cliquez sur Suivant, Tester la requête et Terminer.

(9) Sélectionnez le contrôle Data et affichez la fenêtre Propriétés en appuyant sur F4. Remplacez son ID par NorthwindProducts.

(10) Revenez au panneau Données de la boîte à outils, double-cliquez sur GridView pour ajouter le contrôle à la page et entrez dans le menu Tâches courantes, puis cliquez sur Choisir la source de données. Sélectionnez NorthwindProducts et quittez l’assistant.

(11) Sélectionnez GridView et modifiez son ID en NorthwindProducts. La page devrait ressembler à ceci :

＜%@langue de la page="VB" %＞
<html>
＜head＞＜title＞ch02 TIO 2 Afficher les données MDB＜/title＞＜/head＞
<corps>
＜h3＞ch02 TIO 2 Démonstration de connexion à une source MDB ＜/h3＞
＜formulaire runat="serveur"＞
<asp:accessdatasource id="NorthwindProductsAccDataSource" runat="server"
selectcommand="Sélectionner * Parmi les produits"
datafile="~/App_Data/Northwind.mdb">
＜/asp:accessdatasource＞
<asp:gridview id="NorthwindProductsGridView" runat="server"
datasourceid="NorthwindProductsAccDataSource">
＜/asp:gridview＞
＜/form＞＜/body＞＜/html＞

(12) Ouvrez le navigateur et affichez C:WebsitesBegAspNet2Dbch02ch02_TIO_2_DisplayAccessData.aspx (voir Figure 2-2).

Figure 2-2

(13) L'opération finale consiste à afficher les données de la requête MDB au lieu du tableau. Fermez le navigateur et revenez à VWD. Enregistrez le fichier sous un nouveau nom ch02_TIO_2_DisplayAccessData-Query.aspx. Sélectionnez le GridView et ouvrez son menu de tâches communes en cliquant sur la petite flèche dans le coin supérieur droit du contrôle. Cliquez sur Configurer la source de données et sur Suivant pour ignorer la sélection du fichier MDB. Sur l'interface Configure Select Statement, remplacez le nom par « Sales Classification » et cliquez sur l'astérisque pour obtenir tous les champs. Cette requête joint quatre tables à l'aide de JOIN, limite le nombre d'enregistrements utilisés dans une table et effectue certaines opérations de regroupement et d'agrégation sur les données pour obtenir le total. Cliquez sur Suivant, Testez la requête et Terminez. Le contrôle de la source de données devrait ressembler à ceci :

<asp:accessdatasource id="NorthwindProductsAccDataSource" runat="server"
selectcommand="Sélectionner * De [Ventes par catégorie] "
Datafile="~/App_Data/Northwind.mdb">
＜/asp:accessdatasource＞

(14) Ouvrez le navigateur et affichez la page.

Exemple de note n°2 - Connectez-vous à MDB et affichez les données avec GridView

Vous avez deux contrôles sur la page. Le premier, AccessDataSource, effectue tout le travail de connexion aux objets ADO.NET qui se connectent au moteur JET qui interagit avec le fichier MDB. Le second est GridView, qui permet d'obtenir des données et de convertir leur format au format HTML pouvant être affiché sur la page. Veuillez noter qu'il est très important de donner à chaque contrôle un nom (ID) significatif. Vous devez ensuite vous assurer que le contrôle lié aux données (GridView) utilise sa propriété DataSourceID pour référencer l'ID d'AccessDataSource afin d'utiliser AccessDataSource comme source de données.

L'affichage des données d'une requête n'est pas très difficile ; dans Access, vous pouvez utiliser des noms de requête au lieu de noms de table. Il y a deux instructions ici. Premièrement, s'il y a des espaces dans le nom d'une table ou d'une requête, le nom complet doit être placé entre crochets. Deuxièmement, les requêtes qui nécessitent une saisie de l'utilisateur (par exemple, « ventes au cours d'une année donnée » nécessitent de savoir quelle année) impliquent des techniques qui dépassent le cadre de ce livre.

Après avoir terminé les étapes précédentes, vous pouvez voir les données obtenues à partir du contrôle AccessDataSource affichées sur la page. Les chapitres ultérieurs couvriront GridView en détail, mais ce chapitre continuera à se concentrer sur les contrôles de source de données.

Sélectionner des variables dans les instructions

Lors de la création d'une source de données dans VWD, l'assistant vous demandera de spécifier les colonnes à afficher ou de créer une instruction SQL personnalisée. Dans le précédent "Try It Away", vous avez simplement sélectionné quelques colonnes. Les instructions SQL plus complexes peuvent être spécifiées de plusieurs manières différentes :

● Utiliser des boîtes de dialogue interactives

● Saisissez les instructions SQL personnalisées dans l'assistant AccessDataSource (appelé par la tâche pratique Configurer la source de données dans le contrôle).

● Saisir les instructions dans la grille des propriétés

● Saisir les instructions directement dans le balisage de la vue Source

La sélection de colonnes dans l'assistant Access DataSource est une technique privilégiée pour les requêtes simples qui renvoient une ou plusieurs colonnes d'une table distincte, car elle réduit les erreurs de typographie et de syntaxe (voir Figure 2-3). Dans cet assistant, vous pouvez sélectionner le nom de la table ou de la requête dans la liste déroulante Nom. Vous pouvez ensuite sélectionner les colonnes requises dans la table ou la requête en sélectionnant toutes les colonnes (*) ou n'importe quel groupe de colonnes. Si vous cliquez sur le bouton Trier par, vous pouvez trier selon n'importe quelle colonne de la source de données. S'il y a une contrainte sur la première colonne, le champ sélectionné dans Then By sera utilisé. Lorsque vous sélectionnez des options dans l'assistant, notez que la syntaxe SQL réelle de SelectCommand est également affichée dans une zone de texte en lecture seule.

Figure 2-3

Vous pouvez utiliser le bouton WHERE de l'assistant pour créer une instruction SQL avec des paramètres. Cette partie sera présentée au chapitre 9. Nous allons ignorer cette sélection pour l'instant, mais il est important qu'avant le déploiement, vous utilisiez ces paramètres qui seront abordés plus loin dans ce livre. Dans un site déployé, évitez de connecter directement les entrées utilisateur aux instructions SQL. Ignorer les problèmes de paramètres exposera votre site à des attaques par injection SQL. Cette technique d'attaque utilise de faux caractères provenant des entrées de l'utilisateur pour invalider l'instruction SQL d'origine, puis la remplace par une instruction destructrice. Vous pouvez utiliser des collections de paramètres pour envoyer les entrées utilisateur aux collections de paramètres ADO.NET, qui peuvent utiliser les fonctionnalités des collections pour réduire les problèmes d'injection SQL.

Bien que l'assistant de configuration de la source de données propose de nombreuses options permettant de créer rapidement des instructions SQL, vous devez parfois saisir (ou modifier) directement l'instruction SQL dans la commande SelectCommand marquée. L'assistant AccessDataSource permet ces opérations. Dans la page de l'assistant de sélection des tables, des requêtes et des colonnes, vous pouvez sélectionner le bouton radio « Spécifier une instruction SQL personnalisée ou une procédure stockée ». Après avoir sélectionné cette option dans la page de l'assistant, cliquez sur le bouton Suivant pour accéder à une autre page dans laquelle vous pouvez saisir directement des instructions personnalisées dans la zone de texte. Vous pouvez également utiliser Visual Studio QueryBuilder pour créer visuellement des instructions personnalisées, à l'aide d'outils très similaires à Access QueryBuilder.

Si vous ne souhaitez pas utiliser l'Assistant, vous pouvez choisir d'entrer une instruction SQL personnalisée dans la grille de propriétés du contrôle AccessDataSource, ou vous pouvez basculer vers la vue Source et entrer l'instruction dans la propriété SelectCommand de la balise de contrôle AccessDataSource.

Il existe de nombreux livres sur SQL (du même type que celui-ci est Beginning SQL Programming , ISBN 1-861001-80-0), et ce livre fournit une brève introduction en annexe. Si vous envisagez d'apprendre la syntaxe SQL, vous pouvez commencer par apprendre les commandes pour renvoyer une partie d'un enregistrement (TOP et DISTINCT), la syntaxe pour renommer un champ (AS) et la technique pour renvoyer les champs de deux tables liées (JOIN). . Les exercices suivants exploreront certaines variables dans les instructions SQL.

Essayez n°3 : Modification de l'instruction Select dans AccessDataSource Dans cet exercice, vous afficherez des colonnes et des enregistrements spécifiques de la table Products de Northwind. Une page sera également créée pour afficher les données obtenues à partir de la requête. Veuillez noter que dans cet exercice, les règles de sélection sont déjà dans le code source. Actuellement, il n’existe aucune option de saisie utilisateur.

(1) Créez un fichier nommé ch02_TIO_3_AlternateSelect-Commands.aspx dans C:WebsitesBegAspNet2Dbch02.

(2) Ajoutez un contrôle AccessDataSource avec Northwind comme ID et définissez le MDB sur App_DataNorthwind.mdb. Dans une série de boîtes de dialogue, configurez la commande Sélectionner pour récupérer tous les champs de la table Produits ("nom"=Produits). Jetez un œil à la vue Source et notez l'instruction que vous avez créée, comme indiqué ci-dessous :

SELECT * FROM Produits

(3) Ajoutez GridView, définissez l'ID sur Northwind et définissez la source de données sur Northwind. Voici à quoi ressemble la page entière jusqu'à présent :

＜%@langue de la page="VB" %＞
<html>
＜head runat="serveur"＞
＜titre＞ch02 TIO 3 Commandes de sélection alternatives＜/titre＞
＜/tête＞
<corps>
＜h3＞ch02 TIO 3 Commandes de pièces de sélection alternatives＜/h3＞
＜formulaire runat="serveur"＞
<asp:accessdatasource id="NorthwindAccDataSource" runat="server"
selectcommand="SELECT * FROM Produits"
datafile=" ~/App_Data/Northwind.mdb" >
＜/asp:accessdatasource＞
<asp:gridview id="GridViewl" runat="serveur"
datasourceid="NorthwindAccDataSource">
＜/asp:gridview＞
＜/formulaire＞
＜/corps＞
＜/html＞

(4) Ouvrez maintenant la page dans le navigateur et faites attention à l'interface illustrée dans la figure 2-4 (toutes les colonnes ne sont pas affichées dans la capture d'écran).

Figure 2-4

(5) Revenez à la vue Conception et sélectionnez AccessDataSource (pas GridView). Ouvrez son panneau de tâches pratique et cliquez sur Configurer la source de données. Dans la fenêtre Configurer l'instruction Select, sélectionnez « Spécifier une instruction SQL personnalisée » et cliquez sur Suivant. Modifiez l'instruction SQL dans l'éditeur comme suit :

SELECT * FROM [Produits] WHERE (CategroyID=3)

(6) Cliquez sur Suivant et testez la requête. Cliquez sur OK pour fermer la boîte de dialogue. Jetez un œil à la page dans la vue Source et notez le code suivant :

<asp:accessdatasource id="NorthwindAccDataSource" runat="server"
selectcommand="SELECT * FROM [Produits] WHERE (CategoryID = 3) "
Datafile="~App_Data/Northwind.mdb">
＜/asp:accessdatasource＞

(7) Essayez d'utiliser la boîte de dialogue pour créer certaines des commandes de sélection suivantes. Vous pouvez également les saisir dans la vue Source ou utiliser une combinaison des deux.

SELECT * FROM Produits WHERE ProductID = 12
SELECT * FROM Products WHERE ProductName = 'Sauce aux canneberges Northwoods'
SELECT * FROM Produits WHERE ProductID <11
SELECT * FROM Produits WHERE ProductID <11 ORDER BY ProductName Ascending
SELECT * FROM Produits OÙ ID Fournisseur = 6 OU ID Fournisseur = 8
SELECT * FROM Produits OÙ IDFournisseur = 24 ET PrixUnité ＞ 10

Exemple de note n ° 3 - Modification de l'instruction Select dans AccessDataSource

Dans les premières étapes, créez un contrôle AccessDataSource et GridView comme auparavant. Mais ensuite j'ai commencé à expérimenter les instructions Select. L'ajout et la suppression de colonnes via des cases à cocher sont les plus intuitifs. Vous pouvez également saisir (ou modifier) directement des instructions SQL dans la fenêtre de l'éditeur.

Une clause WHERE a été ajoutée pour limiter les enregistrements renvoyés par le fichier MDB. Si le nom de la colonne ne contient pas d'espaces, les crochets peuvent être omis. Ces crochets doivent être utilisés si le nom de la colonne contient des espaces.

Variables dans l'emplacement du fichier MDB

Les fichiers MDB sont stockés à différents emplacements physiques sur le disque dur : le même dossier que la page Web, un sous-dossier sous la page Web, ou d'autres dossiers sur la machine, etc. Dans Visual Web Developer, ces fichiers peuvent être parcourus fréquemment dans le concepteur et le chemin d'accès correct au fichier MDB a été saisi. Toutefois, si vous envisagez de saisir votre propre code, vous devrez suivre la syntaxe décrite dans cette section.

La propriété DataFile du contrôle AccessDataSource contient un chemin de page qui peut être entièrement qualifié (par exemple, commençant par une lettre de lecteur) ou spécifié par rapport à l'emplacement de la page qui contient AccessDataSource. Les chemins peuvent également être relatifs à l'application, c'est-à-dire utiliser la syntaxe URL pour référencer le chemin. Cette syntaxe remplace le symbole (~) par le répertoire racine de l'application, par exemple : ~App_Dataproduces.mdb. L'utilisation de chemins relatifs à l'application facilite le déplacement de pages d'un emplacement à un autre sans rompre les références à la base de données. Il est donc recommandé d'utiliser des chemins relatifs à l'application autant que possible.

Tout d'abord, examinons la syntaxe d'un chemin complet, qui contient le chemin complet d'un fichier MDB, en commençant par la racine du lecteur de l'ordinateur où se trouve le fichier :

<asp:accessdatasource .

datafile= "C:WebSitesWebApplicationApp_DataMyMdb.mdb">

Bien que cette syntaxe puisse être utilisée, son inconvénient est qu'elle réduit la portabilité de l'application. Si vous déplacez l'application vers une autre machine, le chemin complet vers le lecteur ou le fichier sera différent et vous devrez modifier la propriété DataFile chaque fois que vous déplacez la page.

Une amélioration par rapport aux chemins complets consiste à utiliser la syntaxe de chemin relatif, qui nécessite uniquement de spécifier la partie du chemin complet qui est différente de la page qui contient AccessDataSource. Voici la syntaxe du chemin d'accès d'un fichier de base de données dans le même dossier que la page, spécifié comme chemin relatif :

<asp:accessdatasource .

Étant donné que la page et les fichiers MDB se trouvent dans le même répertoire, il n'y a aucune différence dans les chemins de ces fichiers. Il vous suffit donc de spécifier leurs noms de fichiers respectifs. Si le MDB se trouve dans un ou plusieurs répertoires sous le dossier, la syntaxe suivante est très similaire à la précédente. Dans ce cas, précisez simplement le nom du sous-dossier, suivi d'une barre oblique et du nom du fichier MDF :

<asp:accessdatasource . datafile="MonDossierFille/MonMdb.mdb">.

Si le fichier MDB se trouve dans le répertoire de niveau supérieur du répertoire de pages, vous pouvez également utiliser la syntaxe à double point pour spécifier le répertoire de niveau supérieur de l'emplacement actuel :

<asp:accessdatasource .

En utilisant la syntaxe de chemin relatif, vous pouvez facilement déplacer des applications d'un endroit à un autre sans modifier le chemin du fichier MDB. Étant donné que la page et le fichier MDB sont toujours inséparables (si le fichier MDB fait partie de l'application), les positions relatives de ces fichiers restent toujours cohérentes. Mais que se passe-t-il lorsque vous souhaitez déplacer un chemin au sein de l’application, par exemple déplacer une page vers un sous-répertoire ? Dans ce cas, la position relative entre la page et le fichier MDB a changé et la syntaxe du chemin relatif est incorrecte.

La syntaxe relative de l'application résout ce problème. Dans ce cas, le chemin est toujours spécifié par rapport au répertoire racine de l'application, et non par rapport à la page elle-même. Le répertoire racine est représenté par le symbole (~) :

<asp:accessdatasource .

Vous pouvez désormais facilement déplacer votre application ou déplacer des pages au sein de votre application, sans modifier les références à la base de données. Par conséquent, les chemins relatifs des applications doivent être utilisés autant que possible.