Gestion des événements DataAdapter (ADO.NET)

Mise à jour : November 2007

DataAdapter ADO.NET expose trois événements que vous pouvez utiliser pour répondre aux modifications apportées aux données au niveau de la source de données. Le tableau ci-dessous répertorie les événements DataAdapter.

RowUpdating et RowUpdated

RowUpdating est déclenché avant le traitement d'une mise à jour d'une ligne de l'objet DataSet au niveau de la source de données. RowUpdated est déclenché après le traitement d'une mise à jour d'une ligne de l'objet DataSet au niveau de la source de données. En conséquence, vous pouvez utiliser RowUpdating pour modifier le comportement de mise à jour avant qu'elle n'arrive, pour fournir une gestion supplémentaire lorsqu'une mise à jour survient, pour conserver une référence à une ligne mise à jour, pour annuler la mise à jour en cours et la programmer pour un traitement par lots à traiter ultérieurement, etc. RowUpdated est utile pour répondre aux erreurs et aux exceptions qui surviennent pendant la mise à jour. Vous pouvez ajouter des informations d'erreur au DataSet, ainsi qu'une logique pour les nouvelles tentatives et ainsi de suite.

Les arguments RowUpdatingEventArgs et RowUpdatedEventArgs passés aux événements RowUpdating et RowUpdated comprennent les élément suivants : une propriété Command qui référence l'objet Command utilisé pour effectuer la mise à jour ; une propriété Row qui référence l'objet DataRow contenant les informations mises à jour ; une propriété StatementType pour le type de mise à jour effectuée ; le TableMapping, le cas échéant ; et le Status de l'opération.

Vous pouvez utiliser la propriété Status pour déterminer si une erreur est survenue pendant l'opération et éventuellement contrôler les actions sur les lignes actuelles et qui en résultent. Lorsque l'événement se produit, la propriété Status est égale à Continue ou ErrorsOccurred. Le tableau suivant présente les valeurs que vous pouvez affecter à la propriété Status afin de contrôler les actions ultérieures pendant la mise à jour.

L'affectation de la valeur ErrorsOccurred à la propriété Status entraîne la levée d'une exception. Vous pouvez contrôler l'exception levée en affectant la propriété Errors à l'exception souhaitée. L'utilisation de l'une des autres valeurs pour Status évite la levée d'une exception.

Vous pouvez aussi utiliser la propriété ContinueUpdateOnError pour gérer les erreurs des lignes mises à jour. Si DataAdapter.ContinueUpdateOnError a la valeur true, lorsqu'une mise à jour de ligne entraîne la levée d'une exception, le texte de celle-ci est placé dans les informations RowError de la ligne particulière et le traitement continue sans lever d'exception. Vous pouvez ainsi répondre aux erreurs lorsque Update est terminé, contrairement à l'événement RowUpdated, qui vous permet d'y répondre au moment de l'erreur.

L'exemple de code suivant montre comment ajouter et supprimer les gestionnaires d'événements. Le gestionnaire d'événements RowUpdating écrit un journal de tous les enregistrements supprimés avec un horodatage. Le gestionnaire d'événements RowUpdated ajoute les informations d'erreur à la propriété RowError de la ligne dans le DataSet, supprime l'exception et continue le traitement (en créant une image miroir du comportement de ContinueUpdateOnError = true).

' Assumes that connection is a valid SqlConnection object.
Dim custAdapter As SqlDataAdapter = New SqlDataAdapter( _
  "SELECT CustomerID, CompanyName FROM Customers", connection)

' Add handlers.
AddHandler custAdapter.RowUpdating, New SqlRowUpdatingEventHandler( _
  AddressOf OnRowUpdating)
AddHandler custAdapter.RowUpdated, New SqlRowUpdatedEventHandler(
  AddressOf OnRowUpdated)

' Set DataAdapter command properties, fill DataSet, and modify DataSet.

custAdapter.Update(custDS, "Customers")

' Remove handlers.
RemoveHandler custAdapter.RowUpdating, _
  New SqlRowUpdatingEventHandler(AddressOf OnRowUpdating)
RemoveHandler custAdapter.RowUpdated, _
  New SqlRowUpdatedEventHandler(AddressOf OnRowUpdated)

Private Shared Sub OnRowUpdating(sender As Object, _
  args As SqlRowUpdatingEventArgs)
  If args.StatementType = StatementType.Delete Then
    Dim tw As System.IO.TextWriter = _
  System.IO.File.AppendText("Deletes.log")
    tw.WriteLine( _
      "{0}: Customer {1} Deleted.", DateTime.Now, args.Row(_
      "CustomerID", DataRowVersion.Original))
    tw.Close()
  End If
End Sub

Private Shared Sub OnRowUpdated( _
  sender As Object, args As SqlRowUpdatedEventArgs)
  If args.Status = UpdateStatus.ErrorsOccurred
    args.Status = UpdateStatus.SkipCurrentRow
    args.Row.RowError = args.Errors.Message
  End If
End Sub

// Assumes that connection is a valid SqlConnection object.
SqlDataAdapter custAdapter = new SqlDataAdapter(
  "SELECT CustomerID, CompanyName FROM Customers", connection);

// Add handlers.
custAdapter.RowUpdating += new SqlRowUpdatingEventHandler(OnRowUpdating);
custAdapter.RowUpdated += new SqlRowUpdatedEventHandler(OnRowUpdated);

// Set DataAdapter command properties, fill DataSet, modify DataSet.

custAdapter.Update(custDS, "Customers");

// Remove handlers.
custAdapter.RowUpdating -= new SqlRowUpdatingEventHandler(OnRowUpdating);
custAdapter.RowUpdated -= new SqlRowUpdatedEventHandler(OnRowUpdated);

protected static void OnRowUpdating(
  object sender, SqlRowUpdatingEventArgs args)
{
  if (args.StatementType == StatementType.Delete)
  {
    System.IO.TextWriter tw = System.IO.File.AppendText("Deletes.log");
    tw.WriteLine(
      "{0}: Customer {1} Deleted.", DateTime.Now, 
       args.Row["CustomerID", DataRowVersion.Original]);
    tw.Close();
  }
}

protected static void OnRowUpdated(
  object sender, SqlRowUpdatedEventArgs args)
{
  if (args.Status == UpdateStatus.ErrorsOccurred)
  {
    args.Row.RowError = args.Errors.Message;
    args.Status = UpdateStatus.SkipCurrentRow;
  }
}

FillError

Le DataAdapter émet l'événement FillError en cas d'erreur pendant une opération Fill. Ce type d'erreur se produit habituellement lorsque les données ajoutées dans la ligne n'ont pas pu être converties en type .NET Framework sans perte de précision.

En cas d'erreur pendant une opération Fill, la ligne actuelle n'est pas ajoutée au DataTable. L'événement FillError vous permet de résoudre l'erreur et d'ajouter la ligne, ou d'ignorer la ligne exclue et de poursuivre l'opération Fill.

Le FillErrorEventArgs passé à l'événement FillError peut contenir plusieurs propriétés qui vous permettent de répondre aux erreurs et de les résoudre. Le tableau suivant présente les propriétés de l'objet FillErrorEventArgs.

L'exemple de code suivant ajoute l'événement FillError du DataAdapter à un gestionnaire d'événements. Dans le code d'événement FillError, l'exemple détermine s'il y a une possibilité de perte de précision, donnant ainsi l'opportunité de répondre à l'exception.

AddHandler adapter.FillError, New FillErrorEventHandler( _
  AddressOf FillError)

Dim dataSet As DataSet = New DataSet
adapter.Fill(dataSet, "ThisTable")

Private Shared Sub FillError(sender As Object, _
  args As FillErrorEventArgs)
  If args.Errors.GetType() Is Type.GetType("System.OverflowException") Then
    ' Code to handle precision loss.
    ' Add a row to table using the values from the first two columns.
    DataRow myRow = args.DataTable.Rows.Add(New Object() _
      {args.Values(0), args.Values(1), DBNull.Value})
    ' Set the RowError containing the value for the third column.
    args.RowError = _
      "OverflowException encountered. Value from data source: " & _
      args.Values(2)
    args.Continue = True
  End If
End Sub

adapter.FillError += new FillErrorEventHandler(FillError);

DataSet dataSet = new DataSet();
adapter.Fill(dataSet, "ThisTable");

protected static void FillError(object sender, FillErrorEventArgs args)
{
  if (args.Errors.GetType() == typeof(System.OverflowException))
  {
    // Code to handle precision loss.
    //Add a row to table using the values from the first two columns.
    DataRow myRow = args.DataTable.Rows.Add(new object[]
       {args.Values[0], args.Values[1], DBNull.Value});
    //Set the RowError containing the value for the third column.
    args.RowError = 
       "OverflowException Encountered. Value from data source: " +
       args.Values[2];
    args.Continue = true;
  }
}

Voir aussi

Concepts

Gestion des événements DataSet (ADO.NET)

Gestion des événements DataTable (ADO.NET)

Autres ressources

DataAdapters et DataReaders (ADO.NET)

Gestion et déclenchement d'événements