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

DataContext méthodes (dans le contexte de la LINQ to SQL Tools dans Visual Studio) sont des méthodes de la DataContext classe qui 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 exécutera la procédure stockée ou la fonction dans la base de données à laquelle la méthode DataContext est mappée.In other words, calling these custom methods will run the stored procedure or function in the database that the DataContext method is mapped to. 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, dans des discussions sur DataContext méthodes dans le contexte de la Concepteur O/RO/R Designer, il est le DataContext méthodes qui mappent aux procédures stockées et fonctions qui sont présentées icies.However, in discussions about DataContext methods in the context of the Concepteur O/RO/R Designer, it is the DataContext methods that map to stored procedures and functions that are being discussed.

Volet de méthodesMethods Pane

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/RO/R Designer.DataContext methods that map to stored procedures and functions are displayed in the methods pane of the Concepteur O/RO/R Designer. Le volet de méthodes est le volet le long 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 volet de méthodes répertorie tous les DataContext les méthodes que vous avez créé à l’aide de la Concepteur O/RO/R Designer.The methods pane lists all DataContext methods that you have created by using the Concepteur O/RO/R Designer. 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 base de données sur la Concepteur O/RO/R Designer créer DataContext méthodes et remplir le volet de méthodes.By default, the methods pane is empty; drag stored procedures or functions from Server Explorer/Database Explorer onto the Concepteur O/RO/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 cliquant sur le Concepteur O/RO/R Designer , 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 Concepteur O/RO/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 dans le volet de méthodes du Concepteur O/RO/R Designer.You can create and add DataContext methods on the methods pane of the Concepteur O/RO/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 l’Explorateur de serveurs/l’Explorateur de base de données sur la Concepteur O/RO/R Designer, le type de retour généré DataContext diffère de la méthode selon l’endroit où vous déposez l’élément.When you drag stored procedures and functions from Server Explorer/Database Explorer onto the Concepteur O/RO/R Designer, the return type of the generated DataContext method differs depending on where you drop the item. Placer les é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/RO/R Designer (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 Concepteur O/RO/R Designer (in either pane) creates a DataContext method that returns an automatically generated type. 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.The automatically generated type that is created has a name that matches the stored procedure or function name and properties that 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).

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.Objects you drag from the database onto the O/R Designer surface will be named automatically, based on the name of the objects in the database. 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.If you drag the same object more than once, a number is appended 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