DataContext, méthodes (Concepteur O/R)DataContext Methods (O/R Designer)

DataContext méthodes (dans le contexte de la outils LINQ to SQL dans Visual Studio) sont des méthodes de la DataContext classe qui s’exécutent des procédures stockées et fonctions dans une base de données.DataContext methods (in the context of the LINQ to SQL Tools in Visual Studio) are methods of the DataContext class that run stored procedures and functions in a database.

La classe DataContext est une classe LINQ to SQLLINQ to SQL qui agit comme un conduit entre une base de données SQL Server et les classes d'entité LINQ to SQLLINQ to SQL mappées à cette base de données.The DataContext class is a LINQ to SQLLINQ to SQL class that acts as a conduit between a SQL Server database and the LINQ to SQLLINQ to SQL entity classes mapped to that database. 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.The DataContext class contains the connection string information and the methods for connecting to a database and manipulating the data in the database. 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 SQLLINQ to SQL vers la base de données.By default, the DataContext class contains several methods that you can call, such as the SubmitChanges method that sends updated data from LINQ to SQLLINQ to SQL classes to the database. Vous pouvez également créer d’autres DataContext méthodes qui mappent aux procédures stockées et fonctions.You can also create additional DataContext methods that map to stored procedures and functions. En d’autres termes, l’appel de ces méthodes personnalisées s’exécute la procédure stockée ou une fonction dans la base de données à laquelle le DataContext méthode est mappée.In other words, calling these custom methods runs the stored procedure or function in the database to which the DataContext method is mapped. 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.You can add new methods to the DataContext class just as you would add methods to extend any class. Toutefois, des discussions sur DataContext méthodes dans le contexte de la Concepteur O/R, il est le DataContext méthodes qui mappent aux procédures stockées et fonctions qui sont examinées.However, in discussions about DataContext methods in the context of the O/R Designer, it is the DataContext methods that map to stored procedures and functions that are being discussed.

Volet de méthodesMethods pane

DataContext les méthodes qui mappent aux procédures stockées et fonctions sont affichées dans le méthodes volet de la Concepteur O/R.DataContext methods that map to stored procedures and functions are displayed in the Methods pane of the O/R Designer. Le méthodes volet est le volet le long du côté de la entités volet (l’aire de conception principale).The Methods pane is the pane along the side of the Entities pane (the main design surface). Le méthodes volet répertorie tous les DataContext méthodes que vous avez créé à l’aide de la Concepteur O/R.The Methods pane lists all DataContext methods that you created by using the O/R Designer. Par défaut, le méthodes volet est vide ; faites glisser des procédures stockées ou fonctions de Explorateur de serveurs ou Database Explorer sur la Concepteur O/R créer DataContext méthodes et remplir la méthodes volet.By default, the Methods pane is empty; drag stored procedures or functions from Server Explorer or Database Explorer onto the O/R Designer to create DataContext methods and populate the Methods pane. Pour plus d’informations, consultez Comment : créer un DataContext, méthodes mappées aux procédures stockées et fonctions (Concepteur O/R).For more information, see How to: Create DataContext methods mapped to stored procedures and functions (O/R Designer).

Note

Ouvrir et fermer le volet de méthodes en double-cliquant sur le Concepteur O/R , puis en cliquant sur masquer le volet méthodes ou afficher le volet méthodes, ou utilisez le raccourci clavier CTRL+1.Open and close the methods pane by right-clicking the O/R Designer and then clicking Hide Methods Pane or Show Methods Pane, or use the keyboard shortcut CTRL+1.

Deux types de méthodes DataContextTwo types of DataContext methods

Les méthodes DataContext sont les méthodes qui mappent aux procédures stockées et aux fonctions dans la base de données.DataContext methods are those methods that map to stored procedures and functions in the database. Vous pouvez créer et ajouter des méthodes DataContext sur le méthodes volet de la Concepteur O/R.You can create and add DataContext methods on the Methods pane of the O/R Designer. Il existe deux types distincts de DataContext méthodes ; celles qui retournent un ou plusieurs jeux de résultats et celles qui ne le faites pas :There are two distinct types of DataContext methods; those that return one or more result sets, and those that do not:

Types de retour des méthodes DataContextReturn Types of DataContext Methods

Lorsque vous faites glisser des procédures stockées et des fonctions de Explorateur de serveurs ou Database Explorer sur le Concepteur O/R, le type de retour de généré DataContext méthode diffère selon l’endroit où vous placez l’élément.When you drag stored procedures and functions from Server Explorer or Database Explorer onto the O/R Designer, the return type of the generated DataContext method differs depending on where you drop the item. Suppression d’éléments directement sur une classe d’entité existante crée une DataContext méthode avec le type de retour de la classe d’entité ; placer des éléments dans une zone vide de la Concepteur O/R (dans le volet) crée un DataContext (méthode) qui retourne un type généré automatiquement.Dropping the items directly onto an existing entity class creates a DataContext method with the return type of the entity class; dropping items onto an empty area of the O/R Designer (in either pane) creates a DataContext method that returns an automatically generated type. Le type généré automatiquement a le nom correspond à la procédure stockée ou de nom de la fonction et de propriétés qui correspondent aux champs retournés par la procédure stockée ou une fonction.The automatically generated type has the name that matches the stored procedure or function name and properties, which map to the fields returned by the stored procedure or function.

Note

Vous pouvez modifier le type de retour d'une méthode DataContext après l'avoir ajoutée au volet de méthodes.You can change the return type of a DataContext method after you add it to the methods pane. Pour inspecter ou modifier le type de retour d’un DataContext (méthode), sélectionnez-la et inspectez le Type de retour propriété dans le propriétés fenêtre.To inspect or change the return type of a DataContext method, select it and inspect the Return Type property in the Properties window. Pour plus d’informations, consultez Comment : modifier le type de retour d’une méthode DataContext (Concepteur O/R).For more information, see How to: Change the return type of a DataContext method (O/R Designer).

Objets que vous faites glisser à partir de la base de données sur l’aire du Concepteur O/R sont nommés automatiquement, en fonction du nom des objets dans la base de données.Objects you drag from the database onto the O/R Designer surface are named automatically, based on the name of the objects in the database. Si vous faites glisser le même objet plusieurs fois, un numéro est ajouté à la fin du nouveau nom qui différencie les noms.If you drag the same object more than once, a number is added to the end of the new name that differentiates the names. 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.When database object names contain spaces, or characters not-supported in Visual Basic or C#, the space or invalid character is replaced with an underscore.

Voir aussiSee also