Méthodes DataContext (Concepteur O/R)

Article
05/27/2015

Les méthodes DataContext (dans le contexte du Concepteur Objet/Relationnel (Concepteur O/R)) sont des méthodes de la classe DataContext qui exécutent des procédures stockées et des fonctions dans une base de données.

La classe DataContext est une classe LINQ to SQL qui agit comme un conduit 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, telles que la méthode SubmitChanges qui envoie des données mises à jour des classes LINQ to SQL à 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écutera la procédure stockée ou la fonction 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, à propos des méthodes DataContext dans le contexte du Concepteur O/R, il s'agit des méthodes DataContext qui mappent aux procédures stockées et aux fonctions.

Notes

Dans LINQ to SQL, les procédures stockées et fonctions sont contrôlées de la même façon et mappent aux classes d'entité en utilisant le même StoredProcedureAttribute.Dans le contexte LINQ to SQL, les méthodes DataContext qui mappent aux procédures stockées, sont les mêmes que celles qui mappent aux fonctions.

Volet de méthodes

Les méthodes DataContext qui mappent aux procédures stockées et aux fonctions sont affichées dans le volet de méthodes du Concepteur O/R. Le volet de méthodes est le volet situé le long du côté du volet Entités (l'aire de conception principale). Le volet de méthodes répertorie toutes les méthodes DataContext que vous avez créées en utilisant le Concepteur O/R. Par défaut, le volet de méthodes est vide ; faites glisser des procédures stockées ou des fonctions de l'Explorateur de serveurs/Explorateur de bases de données sur le Concepteur O/R pour créer des méthodes DataContext et remplir le volet de méthodes. Pour plus d'informations, consultez Procédure : créer des méthodes DataContext mappées à des procédures stockées et à des fonctions (Concepteur O/R).

Notes

Ouvrez et fermez le volet de méthodes en cliquant avec le bouton droit sur le Concepteur O/R, et cliquez ensuite sur Masquer le volet méthodes ou Afficher le volet méthodes ou utilisez 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 de 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 Procédure : créer des méthodes DataContext mappées à des procédures stockées et à des fonctions (Concepteur O/R), [T:System.Data.Linq.ISingleResult'1] 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 lorsque 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 Procédure : assigner 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

Lorsque vous faites glisser des procédures stockées et des fonctions de l'Explorateur de serveurs/Explorateur de bases 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 l'un et l'autre volet) crée une méthode DataContext qui retourne un type généré automatiquement. Le type généré automatiquement possède un nom correspondant au nom de la procédure stockée ou de la fonction et des propriétés qui mappent aux champs retournés par la procédure stockée ou fonction.

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 Procédure : modifier 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. Lorsque vous faites glisser plusieurs fois le même objet, un numéro est ajouté à la fin du nouveau nom afin de 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.