Comment : accéder directement à la base de données avec un TableAdapter

Article
08/21/2008

Mise à jour : novembre 2007

Outre InsertCommand, UpdateCommand et DeleteCommand, les TableAdapters sont créés avec des méthodes qui peuvent être exécutées directement sur la base de données. Ces méthodes (TableAdapter.Insert, TableAdapter.Update et TableAdapter.Delete) peuvent être appelées directement pour manipuler des données dans la base de données.

Si vous ne souhaitez pas créer ces méthodes directes, affectez à la propriété GenerateDbDirectMethods du la valeur false dans la fenêtre Propriétés. Toutes les requêtes ajoutées à un TableAdapter en plus de la requête de principal du TableAdapter sont des requêtes autonomes - elles ne génèrent pas ces méthodes DbDirect.

Envoi direct de la commande à une base de données

Appelez la méthode DbDirect du TableAdapter qui exécute la tâche vous tentez d'accomplir.

Pour insérer directement de nouveaux enregistrements dans une base de données

Appelez la méthode Insert du TableAdapter, en passant les valeurs pour chaque colonne en tant que paramètres. La procédure suivante utilise la table Region de la base de données Northwind en tant qu'exemple.

Remarque :

Si vous n'avez pas d'instance disponible, instanciez le TableAdapter que vous voulez utiliser.
```
Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter

regionTableAdapter.Insert(5, "NorthWestern")
```
```
NorthwindDataSetTableAdapters.RegionTableAdapter regionTableAdapter = 
    new NorthwindDataSetTableAdapters.RegionTableAdapter();

regionTableAdapter.Insert(5, "NorthWestern");
```

Pour mettre à jour directement des enregistrements dans une base de données

Appelez la méthode Update du TableAdapter, en passant les valeurs nouvelles et d'origine pour chaque colonne en tant que paramètres.

Remarque :
Si vous n'avez pas d'instance disponible, instanciez le TableAdapter que vous voulez utiliser.

Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter

regionTableAdapter.Update(1, "East", 1, "Eastern")

NorthwindDataSetTableAdapters.RegionTableAdapter regionTableAdapter = 
    new NorthwindDataSetTableAdapters.RegionTableAdapter();

regionTableAdapter.Update(1, "East", 1, "Eastern");

Pour supprimer directement des enregistrements d'une base de données

Appelez la méthode Delete du TableAdapter, en passant les valeurs pour chaque colonne en tant que paramètres de la méthode Delete. (Cet exemple utilise la table Region de la base de données Northwind.)

Remarque :

Si vous n'avez pas d'instance disponible, instanciez le TableAdapter que vous voulez utiliser.
```
Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter

regionTableAdapter.Delete(5, "NorthWestern")
```
```
NorthwindDataSetTableAdapters.RegionTableAdapter regionTableAdapter = 
    new NorthwindDataSetTableAdapters.RegionTableAdapter();

regionTableAdapter.Delete(5, "NorthWestern");
```