Mettre à jour les données à l’aide d’un TableAdapterUpdate data by using a TableAdapter

Une fois que les données dans votre jeu de données a été modifiées et validées, vous pouvez envoyer les données mises à jour vers une base de données en appelant le Update méthode d’un TableAdapter.After the data in your dataset has been modified and validated, you can send the updated data back to a database by calling the Update method of a TableAdapter. Le Update méthode met à jour une table de données unique et exécute la commande correcte (INSERT, UPDATE ou DELETE), selon le RowState de chaque ligne de données dans la table.The Update method updates a single data table and runs the correct command (INSERT, UPDATE, or DELETE) based on the RowState of each data row in the table. Lorsque les tables sont liées à un jeu de données, Visual Studio génère une classe TableAdapterManager qui vous permet d’effectuer les mises à jour.When a dataset has related tables, Visual Studio generates a TableAdapterManager class that you use to do the updates. La classe TableAdapterManager garantit que les mises à jour sont effectuées dans l’ordre approprié selon les contraintes de clé étrangère sont définies dans la base de données.The TableAdapterManager class ensures that updates are made in the correct order based on the foreign-key constraints that are defined in the database. Lorsque vous utilisez des contrôles liés aux données, l’architecture de liaison de données crée une variable de membre de la classe de TableAdapterManager appelée tableAdapterManager.When you use data-bound controls, the databinding architecture creates a member variable of the TableAdapterManager class called tableAdapterManager.

Note

Lorsque vous essayez de mettre à jour d’une source de données avec le contenu d’un dataset, vous pouvez obtenir des erreurs.When you try to update a data source with the contents of a dataset, you can get errors. Pour éviter les erreurs, nous vous recommandons de placer le code qui appelle l’adaptateur Update méthode à l’intérieur d’un try / catch bloc.To avoid errors, we recommend that you put the code that calls the adapter's Update method inside a try/catch block.

La procédure exacte de mise à jour d’une source de données peut varier en fonction des besoins de l’entreprise, mais il comprend les étapes suivantes :The exact procedure for updating a data source can vary depending on business needs, but includes the following steps:

  1. Appeler l’adaptateur Update méthode dans un try / catch bloc.Call the adapter's Update method in a try/catch block.

  2. Si une exception est interceptée, recherchez la ligne de données qui a provoqué l’erreur.If an exception is caught, locate the data row that caused the error.

  3. Résolvez le problème dans les données de ligne (par programmation si possible, ou à l’aide de la ligne non valide pour que l’utilisateur), puis réessayez la mise à jour (HasErrors, GetErrors).Reconcile the problem in the data row (programmatically if you can, or by presenting the invalid row to the user for modification), and then try the update again (HasErrors, GetErrors).

Enregistrer les données dans une base de donnéesSave data to a database

Appelez le Update méthode d’un TableAdapter.Call the Update method of a TableAdapter. Passez le nom de la table de données qui contient les valeurs à écrire dans la base de données.Pass the name of the data table that contains the values to be written to the database.

Pour mettre à jour une base de données à l’aide d’un TableAdapterTo update a database by using a TableAdapter

  • Placez le TableAdapterUpdate méthode dans un try / catch bloc.Enclose the TableAdapter'sUpdate method in a try/catch block. L’exemple suivant montre comment mettre à jour le contenu de la Customers table NorthwindDataSet depuis un try / catch bloc.The following example shows how to update the contents of the Customers table in NorthwindDataSet from within a try/catch block .

    try
    {
        this.Validate();
        this.customersBindingSource.EndEdit();
        this.customersTableAdapter.Update(this.northwindDataSet.Customers);
        MessageBox.Show("Update successful");
    }
    catch (System.Exception ex)
    {
        MessageBox.Show("Update failed");
    }
    
    Try
        Me.Validate()
        Me.CustomersBindingSource.EndEdit()
        Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
        MsgBox("Update successful")
    
    Catch ex As Exception
        MsgBox("Update failed")
    End Try
    

Voir aussiSee also