DataContext, méthodes (Concepteur O/R)
Les méthodes DataContext (dans le contexte des outils LINQ to SQL de Visual Studio) sont des méthodes de la classe DataContext qui exécutent des fonctions et des procédures stockées dans une base de données.
La classe DataContext est une classe LINQ to SQL qui agit comme canal entre une base de données SQL Server et les classes d’entité LINQ to SQL mappées à cette base de données. La classe DataContext contient les informations de chaîne de connexion et les méthodes pour se connecter à une base de données et manipuler les données dans celle-ci. Par défaut, la classe DataContext contient plusieurs méthodes que vous pouvez appeler comme la méthode SubmitChanges, qui envoie des données mises à jour des classes LINQ to SQL vers la base de données. Vous pouvez également créer des méthodes DataContext supplémentaires pour mapper aux procédures stockées et aux fonctions. En d’autres termes, l’appel de ces méthodes personnalisées exécute la fonction ou la procédure stockée dans la base de données à laquelle la méthode DataContext est mappée. Vous pouvez ajouter de nouvelles méthodes à la classe DataContext en procédant comme pour l'ajout de toute autre méthode destinée à étendre une classe. Toutefois, quand il est fait référence aux méthodes DataContext dans le contexte du Concepteur O/R, il s’agit des méthodes DataContext mappées aux fonctions et procédures stockées.
Volet Méthodes
Les méthodes DataContext mappées aux fonctions et procédures stockées sont affichées dans le volet Méthodes du Concepteur O/R. Le volet Méthodes est le volet situé le long du côté du volet Entités (l’aire de conception principale). Le volet Méthodes liste toutes les méthodes DataContext que vous avez créées en utilisant le Concepteur O/R. Par défaut, le volet Méthodes est vide. Faites glisser des fonctions ou des procédures stockées de l’Explorateur de serveurs ou de l’explorateur de base de données vers le Concepteur O/R pour créer des méthodes DataContext et remplir le volet Méthodes. Pour plus d’informations, consultez Guide pratique pour créer des méthodes DataContext mappées à des fonctions et des procédures stockées (Concepteur O/R).
Notes
Ouvrez et fermez le volet de méthodes en cliquant avec le bouton droit sur le Concepteur O/R, puis en cliquant sur Masquer le volet Méthodes ou Afficher le volet Méthodes ou en utilisant le raccourci clavier Ctrl+1.
Deux types de méthodes DataContext
Les méthodes DataContext sont les méthodes qui mappent aux procédures stockées et aux fonctions dans la base de données. Vous pouvez créer et ajouter des méthodes DataContext dans le volet Méthodes du Concepteur O/R. Il existe deux types distincts de méthodes DataContext : celles qui retournent un ou plusieurs jeux de résultats et celles qui ne retournent aucun jeu de résultats :
Méthodes DataContext qui retournent un ou plusieurs jeux de résultats :
Créez ce type de méthode DataContext lorsque votre application doit juste exécuter des procédures stockées et des fonctions dans la base de données et retourner les résultats. Pour plus d’informations, consultez Guide pratique pour créer des méthodes DataContext mappées à des fonctions et des procédures stockées (Concepteur O/R), System.Data.Linq.ISingleResult<T> et IMultipleResults.
Méthodes DataContext qui ne retournent aucun jeu de résultats, par exemple celles qui effectuent des insertions, des mises à jour et des suppressions pour une classe d'entité spécifique.
Créez ce type de méthode DataContext quand votre application doit exécuter des procédures stockées au lieu d’utiliser le comportement LINQ to SQL par défaut pour enregistrer des données modifiées entre une classe d’entité et la base de données. Pour plus d’informations, consultez Guide pratique pour attribuer des procédures stockées pour effectuer des mises à jour, des insertions et des suppressions (Concepteur O/R).
Types de retour des méthodes DataContext
Quand vous faites glisser des fonctions et des procédures stockées de l’Explorateur de serveurs ou de l’explorateur de base de données vers le Concepteur O/R, le type de retour de la méthode DataContext générée diffère selon l’endroit où vous placez l’élément. Placer directement les éléments sur une classe d’entité existante crée une méthode DataContext avec le type de retour de la classe d’entité. Placer des éléments dans une zone vide du Concepteur O/R (dans un volet ou dans l’autre) crée une méthode DataContext qui retourne un type généré automatiquement. Le type généré automatiquement a un nom correspondant au nom de la fonction ou de la procédure stockée et des propriétés mappées aux champs retournés par la fonction ou la procédure stockée.
Notes
Vous pouvez modifier le type de retour d’une méthode DataContext après l’avoir ajoutée au volet de méthodes. Pour inspecter ou modifier le type de retour d’une méthode DataContext, sélectionnez-la et inspectez la propriété Type de retour dans la fenêtre Propriétés. Pour plus d’informations, consultez Guide pratique pour changer le type de retour d’une méthode DataContext (Concepteur O/R).
Les objets que vous faites glisser de la base de données vers l’aire du Concepteur O/R sont nommés automatiquement en fonction du nom des objets dans la base de données. Quand vous faites glisser plusieurs fois le même objet, un numéro est ajouté à la fin du nouveau nom pour différencier les noms. Lorsque les noms des objets de la base de données contiennent des espaces ou des caractères non pris en charge en Visual Basic ou en C#, l'espace ou le caractère non valide est remplacé par un trait de soulignement.
Contenu connexe
- Outils LINQ to SQL dans Visual Studio
- LINQ to SQL
- procédures stockées
- Guide pratique pour créer des méthodes DataContext mappées à des procédures stockées et à des fonctions (Concepteur O/R)
- Guide pratique pour affecter des procédures stockées pour effectuer des mises à jour, des insertions et des suppressions (Concepteur O/R)
- Procédure pas à pas : personnalisation du comportement d’insertion, de mise à jour et de suppression de classes d’entité
- Procédure pas à pas : Création de classes LINQ to SQL (Concepteur O/R)