Visualiseur de requête LINQ, exemple

Article
08/21/2008

Mise à jour : novembre 2007

Le Visualiseur de requête est un assembly qui peut être utilisé dans une session de débogage Visual Studio pour visualiser des requêtes de base de données. Le projet lui-même est une simple bibliothèque et ne peut pas être exécuté. Si vous le compilez, une bibliothèque (DLL) est générée. Celle-ci peut être utilisée dans Visual Studio pour améliorer votre capacité de déboguer des applications LINQ to SQL.

Remarque :
Lorsque vous déboguez des applications à l'aide du visualiseur, vous pouvez être amené à ajouter Persist Security Info=true à la chaîne de connexion. Lorsque le débogueur est activé, il sérialise des informations du programme en cours de débogage et l'envoie au processus qui affiche le visualiseur. Un renseignement sérialisé est la chaîne de connexion obtenue à partir de l'objet SqlConnection. Par défaut, l'objet SqlConnection ne retourne pas le mot de passe et, par conséquent, la chaîne de connexion sans le mot de passe est sérialisée et envoyée au visualiseur. Lorsque vous essayez d'exécuter la requête dans le visualiseur, celle-ci peut échouer en raison de l'absence de mot de passe. Utilisez uniquement ce paramètre lors du débogage. Nous ne recommandons pas ce paramètre pour la production.

Lorsque vous déboguez des applications à l'aide du visualiseur, vous pouvez être amené à ajouter Persist Security Info=true à la chaîne de connexion. Lorsque le débogueur est activé, il sérialise des informations du programme en cours de débogage et l'envoie au processus qui affiche le visualiseur. Un renseignement sérialisé est la chaîne de connexion obtenue à partir de l'objet SqlConnection. Par défaut, l'objet SqlConnection ne retourne pas le mot de passe et, par conséquent, la chaîne de connexion sans le mot de passe est sérialisée et envoyée au visualiseur. Lorsque vous essayez d'exécuter la requête dans le visualiseur, celle-ci peut échouer en raison de l'absence de mot de passe. Utilisez uniquement ce paramètre lors du débogage. Nous ne recommandons pas ce paramètre pour la production.

Pour obtenir des exemples et leurs instructions d'installation

Effectuez une ou plusieurs des opérations suivantes :
- Dans le menu ? (Aide), cliquez sur Exemples.
  
  Le fichier Readme contient des informations sur les exemples.
- Accédez au site Web Exemples Visual Studio 2008. La version la plus récente des exemples est disponible sur ce site.
- Recherchez les exemples sur l'ordinateur sur lequel Visual Studio est installé. Par défaut, les exemples et un fichier Readme sont installés sous lecteur:\Program Files\Microsoft Visual Studio 9.0\Samples\1036. Pour les versions Express de Visual Studio, tous les exemples sont disponibles en ligne.

Pour plus d'informations, consultez Recherche des fichiers d'exemple.

Note de sécurité :
Cet exemple de code est destiné à illustrer un concept ; il présente uniquement le code qui se rapporte spécifiquement à ce concept. Il est possible qu'il ne réponde pas aux exigences de sécurité d'un environnement spécifique, et ne doit pas être utilisé exactement comme indiqué. Nous vous recommandons d'ajouter du code de sécurité et de gestion des erreurs afin de renforcer la sécurité et la fiabilité de vos projets. Microsoft fournit cet exemple de code « EN L'ÉTAT » sans aucune garantie.

Cet exemple de code est destiné à illustrer un concept ; il présente uniquement le code qui se rapporte spécifiquement à ce concept. Il est possible qu'il ne réponde pas aux exigences de sécurité d'un environnement spécifique, et ne doit pas être utilisé exactement comme indiqué. Nous vous recommandons d'ajouter du code de sécurité et de gestion des erreurs afin de renforcer la sécurité et la fiabilité de vos projets. Microsoft fournit cet exemple de code « EN L'ÉTAT » sans aucune garantie.

Pour exécuter cet exemple

Ouvrez et générez le projet du Visualiseur de requête.
Copiez la DLL générée par la compilation du répertoire bin de votre projet dans le répertoire du Visualiseur, qui, par défaut est situé sous C:\Users\UserName\Documents\Visual Studio 2008\Visualizers. Vous devrez peut-être créer le répertoire Visualizers. Dans Windows XP et les versions antérieures, utilisez le répertoire Mes documents plutôt que le répertoire Documents. Si vous disposez des autorisations, vous pouvez également copier le fichier vers le répertoire suivant : ...\Program Files\Microsoft Visual Studio 9.0\Common7\Packages\Debugger\Visualizers
Si nécessaire, quittez Visual Studio et redémarrez pour vous assurer que le visualiseur est reconnu.
Testez le visualiseur dans un exemple de projet existant, tel que SampleQueries, ou créez une nouvelle application console pour y tester le visualiseur. Pour créer une application, procédez comme suit :
1. Créez une application console par défaut.
2. Utilisez l'Concepteur Objet/Relationnel à attacher à la base de données Northwind située dans le répertoire d'exemples.
3. Ouvrez la boîte de dialogue Ajouter un nouvel élément (Ctrl-Maj-A) et cliquez sur Classes LINQ to SQL.
4. Ouvrez l'Explorateur de serveurs en appuyant sur Ctrl + W, L.
5. Dans l'Explorateur de serveurs, cliquez sur le bouton Se connecter à la base de données. Si nécessaire, sélectionnez Fichier de base de données Microsoft SQL Server comme Source de données. Recherchez la base de données Northwind.mdb dans le répertoire de données inclus avec les exemples.
6. Faites glisser la table Customers sur l'aire du concepteur.
7. Écrivez et appelez une requête simple telle que celle ci-dessous :
```
public void SimpleQuery()
{
    DataClasses1DataContext db = new DataClasses1DataContext();
    var query = from c in db.Customers
                select c;
    foreach (var item in query)
        Console.WriteLine(item.CompanyName);
}
```
8. Placez un point d'arrêt sur la ligne foreach et demandez son exécution.
9. Passez le pointeur de déplacement sur la requête de nom de variable et cliquez sur l'icône de loupe qui apparaît.

Démonstrations

Le visualiseur de requête est un utilitaire pratique qui peut être exécuté dans le débogueur.

Remarque :
De nombreux exemples LINQ requièrent des fichiers XML et/ou la version de l'exemple de base de données Northwind disponible dans l'exemple Data. Si vous installez l'exemple Data (voir Données, exemple) dans le même dossier parent que les autres exemples LINQ, le chemin d'accès aux fichiers XML et au fichier de base de données sera résolu automatiquement. De nombreux fichiers d'exemple requièrent également le projet Object Dumper, exemple.

De nombreux exemples LINQ requièrent des fichiers XML et/ou la version de l'exemple de base de données Northwind disponible dans l'exemple Data. Si vous installez l'exemple Data (voir Données, exemple) dans le même dossier parent que les autres exemples LINQ, le chemin d'accès aux fichiers XML et au fichier de base de données sera résolu automatiquement. De nombreux fichiers d'exemple requièrent également le projet Object Dumper, exemple.

Voir aussi

Autres ressources

Exemples LINQ en C#

Mise en route (LINQ to XML)

Partager via