Comment : retourner un résultat de requête LINQ en tant que type spécifique (Visual Basic)

  • Article

LINQ (Language-Integrated Query) facilite l'accès aux informations de la base de données et l'exécution des requêtes. Par défaut, les requêtes LINQ retournent une liste d'objets sous forme de type anonyme. Vous pouvez également spécifier qu'une requête retourne une liste d'un type spécifique en utilisant la clause Select.

L'exemple suivant indique comment créer une nouvelle application qui effectue des requêtes sur une base de données SQL Server et projette les résultats sous forme de type nommé spécifique. Pour plus d'informations, consultez Types anonymes (Visual Basic) et Select, clause (Visual Basic).

Les exemples de cette rubrique utilisent l'exemple de base de données Northwind. Si vous ne disposez pas de l'exemple de base de données Northwind sur votre ordinateur de développement, vous pouvez le télécharger sur le site Web du Centre de téléchargement Microsoft. Pour obtenir des instructions, consultez Téléchargement d'exemples de bases de données (LINQ to SQL).

Notes

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour créer une connexion à une base de données

  1. Dans Visual Studio, ouvrez l'Explorateur de serveurs/Explorateur de bases de données en cliquant sur Explorateur de serveurs ou Explorateur de bases de données dans le menu Affichage.

  2. Dans l'Explorateur de serveurs/Explorateur de bases de données, cliquez avec le bouton droit sur Connexions de données, puis sur Ajouter une connexion.

  3. Spécifiez une connexion valide à l'exemple de base de données Northwind.

Pour ajouter un projet contenant un fichier LINQ to SQL

  1. Dans le menu Fichier de Visual Studio, pointez sur Nouveau, puis cliquez sur Projet. Sélectionnez Application Windows Forms Visual Basic comme type de projet.

  2. Dans le menu Projet, cliquez sur Ajouter un nouvel élément. Sélectionnez le modèle d'élément Classes LINQ to SQL.

  3. Nommez le fichier northwind.dbml. Cliquez sur Ajouter. Le fichier northwind.dbml s'ouvre dans le Concepteur Objet/Relationnel (Concepteur O/R).

Pour ajouter des tables à interroger au Concepteur O/R

  1. Dans l'Explorateur de serveurs/Explorateur de bases de données, développez la connexion à la base de données Northwind. Développez le dossier Tables.

    Si vous avez fermé le Concepteur O/R, vous pouvez le rouvrir en double-cliquant sur le fichier northwind.dbml que vous avez ajouté précédemment.

  2. Cliquez sur la table Customers et faites-la glisser dans le volet gauche du concepteur.

    Le concepteur crée un nouvel objet Customer pour votre projet. Vous pouvez projeter un résultat de requête comme type Customer ou comme un type que vous créez. Cet exemple créera un nouveau type dans une procédure ultérieure et projettera un résultat de requête sous la forme de ce type.

  3. Enregistrez vos modifications et fermez le concepteur.

  4. Enregistrez votre projet.

Pour ajouter du code en vue d'interroger la base de données et afficher les résultats

  1. À partir de la Boîte à outils, faites glisser un contrôle DataGridView sur le Windows Form par défaut pour votre projet, Form1.

  2. Double-cliquez sur Form1 pour modifier la classe Form1.

  3. Après l'instruction End Class de la classe Form1, ajoutez le code suivant pour créer un type CustomerInfo pour stocker les résultats de la requête pour cet exemple.

    Public Class CustomerInfo
  Public Property CompanyName As String
  Public Property ContactName As String
End Class

  4. Lorsque vous avez ajouté des tables au Concepteur O/R, le concepteur a ajouté un objet DataContext à votre projet. Cet objet contient le code indispensable pour accéder à ces tables, ainsi qu'aux collections et objets individuels de chaque table. L'objet DataContext pour votre projet est nommé d'après le nom de votre fichier .dbml. Pour ce projet, l'objet DataContext est nommé northwindDataContext.

    Vous pouvez créer une instance du DataContext dans votre code et interroger les tables spécifiées par le Concepteur O/R.

    Ajoutez le code suivant à l'événement Load de la classe Form1 pour interroger les tables qui sont exposées comme propriétés de votre contexte de données. La clause Select de la requête créera un nouveau type CustomerInfo au lieu d'un type anonyme pour chaque élément du résultat de la requête.

    Dim db As New northwindDataContext

Dim customerList =
  From cust In db.Customers
  Where cust.CompanyName.StartsWith("L")
  Select New CustomerInfo With {.CompanyName = cust.CompanyName,
                                .ContactName = cust.ContactName}

DataGridView1.DataSource = customerList

  5. Appuyez sur F5 pour exécuter votre projet et consulter les résultats.

Voir aussi

Tâches

Procédure pas à pas : création de classes LINQ to SQL (Concepteur O/R)

Concepts

Méthodes DataContext (Concepteur O/R)

Autres ressources

LINQ en Visual Basic

Requêtes (Visual Basic)

LINQ to SQL