Créer et configurer des TableAdaptersCreate and configure TableAdapters

Les TableAdapters fournissent la communication entre votre application et une base de données.TableAdapters provide communication between your application and a database. Ils se connectent à la base de données, exécuter des requêtes ou de procédures stockées et renvoient les nouvelles données de table ou de remplir un existant DataTable avec les données retournées.They connect to the database, run queries or stored procedures, and either return a new data table or fill an existing DataTable with the returned data. Les TableAdapters peuvent également envoyer des données mises à jour à partir de votre application dans la base de données.TableAdapters can also send updated data from your application back to the database.

Les TableAdapters sont créés pour vous lorsque vous effectuez l’une des actions suivantes :TableAdapters are created for you when you perform one of the following actions:

  • Faire glisser des objets de base de données à partir de Explorateur de serveurs dans le Concepteur de Dataset.Drag database objects from Server Explorer into the Dataset Designer.

  • Exécutez l’Assistant de Configuration de Source de données, puis sélectionnez soit le base de données ou Service Web type de source de données.Run the Data Source Configuration Wizard, and select either the Database or Web Service data source type.

    Assistant de Configuration de Source de données dans Visual Studio

Vous pouvez également créer un nouveau TableAdapter et configurez-le avec une source de données en faisant glisser un TableAdapter à partir de la boîte à outils une zone vide dans le Concepteur de Dataset surface.You can also create a new TableAdapter and configure it with a data source by dragging a TableAdapter from the Toolbox to an empty region in the Dataset Designer surface.

Pour une introduction aux TableAdapters, consultez remplir des jeux de données à l’aide de TableAdapters.For an introduction to TableAdapters, see Fill datasets by using TableAdapters.

Note

Il est possible que pour certains des éléments de l’interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. L’édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments.The Visual Studio edition that you have and the settings that you use, determine these elements. Pour plus d’informations, consultez Personnaliser l’IDE.For more information, see Personalize the IDE.

Utilisez l’Assistant Configuration de TableAdapterUse the TableAdapter Configuration Wizard

Exécutez le Assistant Configuration de TableAdapter pour créer ou modifier des TableAdapters et leurs DataTables associés.Run the TableAdapter Configuration Wizard to create or edit TableAdapters and their associated DataTables. Vous pouvez configurer un TableAdapter existant en cliquant dessus dans le Concepteur de Dataset.You can configure an existing TableAdapter by right-clicking on it in the Dataset Designer.

raddata Assistant de Configuration de l’adaptateur de Table

Si vous faites glisser un TableAdapter à partir de la boîte à outils lorsque le Concepteur de Dataset est en cours se concentrent, l’Assistant démarre et invites vous permettent de spécifier les données source le TableAdapter doivent se connecter.If you drag a new TableAdapter from the Toolbox when the Dataset Designer is in focus, the wizard starts and prompts you to specify which data source the TableAdapter should connect to. Sur la page suivante, l’Assistant vous demande quel type de commandes, il doit utiliser pour communiquer avec la base de données, des instructions SQL ou procédures stockées.On the next page, the wizard asks what kind of commands it should use to communicate with the database, either SQL statements or stored procedures. (Vous ne voyez pas cela si vous configurez un TableAdapter est déjà associé à une source de données.)(You won't see this if you are configuring a TableAdapter that is already associated with a data source.)

  • Vous avez la possibilité de créer une nouvelle procédure stockée dans la base de données sous-jacent, si vous avez les autorisations appropriées pour la base de données.You have the option to create a new stored procedure in the underlying database if you have the correct permissions for the database. Si vous n’avez pas ces autorisations, ce ne sera pas une option.If you don't have these permissions, this won't be an option.

  • Vous pouvez également choisir d’exécuter des procédures stockées existantes pour le sélectionnez, insérer, mise à jour, et supprimer commandes de la TableAdapter.You can also choose to run existing stored procedures for the SELECT, INSERT, UPDATE, and DELETE commands of the TableAdapter. La procédure stockée qui est affectée à la mise à jour commande, par exemple, est exécutée lorsque la TableAdapter.Update() méthode est appelée.The stored procedure that's assigned to the Update command, for example, is run when the TableAdapter.Update() method is called.

Mappez les paramètres de la procédure stockée sélectionnée aux colonnes correspondantes de la table de données.Map parameters from the selected stored procedure to the corresponding columns in the data table. Par exemple, si votre procédure stockée accepte un paramètre nommé @CompanyName qu’il transmet à la CompanyName jeu de colonnes dans la table, le colonne Source de la @CompanyName paramètre à CompanyName.For example, if your stored procedure accepts a parameter named @CompanyName that it passes to the CompanyName column in the table, set the Source Column of the @CompanyName parameter to CompanyName.

Note

La procédure stockée qui est affectée à la commande SELECT est exécutée en appelant la méthode du TableAdapter que vous nommez dans l’étape suivante de l’Assistant.The stored procedure that's assigned to the SELECT command is run by calling the method of the TableAdapter that you name in the next step of the wizard. La méthode par défaut est Fill, de sorte que le code qui est généralement utilisé pour exécuter la procédure SELECT est TableAdapter.Fill(tableName).The default method is Fill, so the code that's typically used to run the SELECT procedure is TableAdapter.Fill(tableName). Si vous modifiez le nom par défaut à partir de Fill, remplacez Fill avec le nom vous affecter et remplacez « TableAdapter » par le nom réel du TableAdapter (par exemple, CustomersTableAdapter).If you change the default name from Fill, substitute Fill with the name you assign, and replace "TableAdapter" with the actual name of the TableAdapter (for example, CustomersTableAdapter).

  • En sélectionnant le créer des méthodes pour envoyer des mises à jour directement à la base de données option revient à affecter la GenerateDBDirectMethods true à la propriété.Selecting the Create methods to send updates directly to the database option is equivalent to setting the GenerateDBDirectMethods property to true. L’option n’est pas disponible lorsque l’instruction SQL d’origine ne fournit pas de suffisamment d’informations ou de la requête n’est pas une requête modifiable.The option is unavailable when the original SQL statement does not provide enough information or the query is not an updateable query. Cette situation peut se produire, par exemple, dans joindre requêtes et les requêtes qui retournent une valeur (scalaire) unique.This situation can occur, for example, in JOIN queries and queries that return a single (scalar) value.

Le Options avancées dans l’Assistant permettent :The Advanced Options in the wizard enable you to:

  • Générer des instructions INSERT, UPDATE et DELETE en fonction de l’instruction SELECT qui est définie sur le générer les instructions SQL pageGenerate INSERT, UPDATE, and DELETE statements based on the SELECT statement that's defined on the Generate SQL statements page
  • Utiliser l'accès concurrentiel optimisteUse optimistic concurrency
  • Spécifiez s’il faut actualiser la table de données après insertion et exécutent des instructions de mise à jourSpecify whether to refresh the data table after INSERT and UPDATE statements are run

Configurer la méthode de remplissage d’un TableAdapterConfigure a TableAdapter's Fill method

Parfois, vous souhaiterez modifier le schéma de table du TableAdapter.Sometimes you might want to change the schema of the TableAdapter's table. Pour ce faire, vous modifiez les principaux du TableAdapter Fill (méthode).To do this, you modify the TableAdapter's primary Fill method. Les TableAdapters sont créés avec un réplica principal Fill la méthode qui définit le schéma de la table de données associée.TableAdapters are created with a primary Fill method that defines the schema of the associated data table. Le réplica principal Fill méthode est basée sur la requête ou la procédure stockée que vous avez entré lorsque vous avez configuré à l’origine du TableAdapter.The primary Fill method is based on the query or stored procedure you entered when you originally configured the TableAdapter. Il est la première méthode (plus élevée) sous la table de données dans le Concepteur de DataSet.It's the first (topmost) method under the data table in the DataSet Designer.

TableAdapter avec plusieurs requêtes

Principale de toutes les modifications que vous apportez au TableAdapter Fill méthode sont reflétées dans le schéma de la table de données associée.Any changes that you make to the TableAdapter's main Fill method are reflected in the schema of the associated data table. Par exemple, suppression d’une colonne à partir de la requête dans le principal Fill méthode supprime également la colonne de la table de données associée.For example, removing a column from the query in the main Fill method also removes the column from the associated data table. En outre, suppression de la colonne à partir de la main Fill méthode supprime la colonne de toutes les requêtes supplémentaires pour ce TableAdapter.Additionally, removing the column from the main Fill method removes the column from any additional queries for that TableAdapter.

Vous pouvez utiliser l’Assistant Configuration de requête TableAdapter pour créer et modifier des requêtes supplémentaires du TableAdapter.You can use the TableAdapter Query Configuration Wizard to create and edit additional queries for the TableAdapter. Ces requêtes supplémentaires doivent être conformes au schéma de table, sauf si elles retournent une valeur scalaire.These additional queries must conform to the table schema, unless they return a scalar value. Chaque requête supplémentaire a un nom que vous spécifiez.Each additional query has a name that you specify.

L’exemple suivant vous montre comment appeler une requête supplémentaire nommée FillByCity:The following example shows you how to call an additional query named FillByCity:

CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")

Pour démarrer l’Assistant Configuration de requêtes TableAdapter avec une nouvelle requêteTo start the TableAdapter Query Configuration Wizard with a new query

  1. Ouvrez votre jeu de données dans le Concepteur de Dataset.Open your dataset in the Dataset Designer.

  2. Si vous créez une nouvelle requête, faites glisser un requête de l’objet à partir de la DataSet onglet de la boîte à outils sur un DataTable, ou sélectionnez ajouter une requêteà partir du menu contextuel du TableAdapter.If you are creating a new query, drag a Query object from the DataSet tab of the Toolbox onto a DataTable, or select Add Query from the TableAdapter's shortcut menu. Vous pouvez également faire glisser un requête objet dans une zone vide de la Concepteur de Dataset, ce qui crée un TableAdapter sans associé à un DataTable.You can also drag a Query object onto an empty area of the Dataset Designer, which creates a TableAdapter without an associated DataTable. Ces requêtes peuvent uniquement retourner des valeurs (scalaires) uniques, ou exécutez UPDATE, INSERT, ou supprimer des commandes sur la base de données.These queries can only return single (scalar) values, or run UPDATE, INSERT, or DELETE commands against the database.

  3. Sur le choisir votre connexion de données écran, sélectionnez ou créez la connexion que la requête va utiliser.On the Choose Your Data Connection screen, select or create the connection that the query will use.

    Note

    Cet écran s’affiche uniquement lorsque le concepteur ne peut pas déterminer la connexion appropriée à utiliser, ou lorsqu’aucune connexion n’est disponible.This screen only appears when the designer can't determine the proper connection to use, or when no connections are available.

  4. Sur le choisir un Type de commande s’affiche, sélectionnez parmi les méthodes d’extraction de données à partir de la base de données suivantes :On the Choose a Command Type screen, select from the following methods of fetching data from the database:

    • Utiliser des instructions SQL vous permet de taper une instruction SQL pour sélectionner les données à partir de votre base de données.Use SQL statements enables you to type a SQL statement to select the data from your database.

    • Créer la nouvelle procédure stockée vous permet de l’Assistant créer une nouvelle procédure stockée (dans la base de données) en fonction de l’instruction SELECT spécifiée.Create new stored procedure enables you to have the wizard create a new stored procedure (in the database) based on the specified SELECT statement.

    • Utiliser des procédures stockées existantes vous permet d’exécuter une procédure stockée existante lors de l’exécution de la requête.Use existing stored procedures enables you to run an existing stored procedure when running the query.

Pour démarrer l’Assistant Configuration de requête TableAdapter sur une requête existanteTo start the TableAdapter Query Configuration wizard on an existing query

  • Si vous modifiez une requête TableAdapter existante, avec le bouton droit de la requête, puis choisissez configurer dans le menu contextuel.If you are editing an existing TableAdapter query, right-click the query, and then choose Configure from the shortcut menu.

    Note

    Clic droit sur la requête principale d’un TableAdapter reconfigure le TableAdapter et DataTable schéma.Right-clicking the main query of a TableAdapter reconfigures the TableAdapter and DataTable schema. Clic droit sur une requête supplémentaire sur un TableAdapter, cependant, configure la requête sélectionnée uniquement.Right-clicking an additional query on a TableAdapter, however, configures the selected query only. Le Assistant Configuration de TableAdapter reconfigure la définition du TableAdapter, tandis que le Assistant Configuration de requêtes TableAdapter reconfigure uniquement la requête sélectionnée.The TableAdapter Configuration Wizard reconfigures the TableAdapter definition, while the TableAdapter Query Configuration Wizard reconfigures the selected query only.

Pour ajouter une requête globale à un TableAdapterTo add a global query to a TableAdapter

  • Requêtes globales sont des requêtes SQL qui retournent une valeur (scalaire) unique ou aucune valeur.Global queries are SQL queries that return either a single (scalar) value or no value. En règle générale, les fonctions globales effectuent des opérations de base de données telles que des insertions, mises à jour et suppressions.Typically, global functions perform database operations such as inserts, updates, and deletes. Ils regroupent également des informations, telles qu’un nombre de clients dans une table ou le total des frais pour tous les éléments dans un ordre particulier.They also aggregate information, such as a count of customers in a table or the total charges for all items in a particular order.

    Vous ajoutez des requêtes globales en faisant glisser un requête à partir de l’objet le DataSet onglet de la boîte à outils dans une zone vide de la Concepteur de Dataset.You add global queries by dragging a Query object from the DataSet tab of the Toolbox onto an empty area of the Dataset Designer.

  • Fournir une requête qui effectue la tâche souhaitée, par exemple, SELECT COUNT(*) AS CustomerCount FROM Customers.Provide a query that performs the desired task, for example, SELECT COUNT(*) AS CustomerCount FROM Customers.

    Note

    En faisant glisser un requête objet directement sur le Concepteur de Dataset crée une méthode qui retourne uniquement une valeur scalaire (unique).Dragging a Query object directly onto the Dataset Designer creates a method that returns only a scalar (single) value. Alors que la requête ou la procédure stockée que vous sélectionnez peut-être retourner plus de valeur unique, la méthode qui est créée par l’Assistant retourne uniquement une valeur unique.While the query or stored procedure you select might return more than a single value, the method that's created by the wizard only returns a single value. Par exemple, la requête peut retourner la première colonne de la première ligne des données retournées.For example, the query might return the first column of the first row of the returned data.

Voir aussiSee also