Gestion d’événements DataAdapter

S'applique à : .NET Framework .NET .NET Standard

Télécharger ADO.NET

Le fournisseur de données Microsoft SqlClient pour SQL Server SqlDataAdapter 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.

Événements 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 la mise à jour avant qu'elle ne survienne, pour fournir une gestion supplémentaire lors d'une mise à jour, 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éagir aux erreurs et aux exceptions qui surviennent pendant la mise à jour. Vous pouvez ajouter des informations d’erreur au DataSet ainsi qu’logique de nouvelle tentative, etc.

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 Status à la propriété ErrorsOccurred 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 (reflétant le comportement de ContinueUpdateOnError = true).

static DataSet DataAdapterEventsDemo(SqlConnection connection, DataSet custDS)
{
    // Assumes that connection is a valid SqlConnection object 
    // and custDS includes the Customers table.
    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);

    return custDS;
}

protected static void OnRowUpdating(object sender, SqlRowUpdatingEventArgs args)
{
    if (args.StatementType == StatementType.Delete)
    {
        // Saves the removing rows with additional information in a file.
        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)
    {
        // Adds the error message to the row and skips from it.
        args.Row.RowError = args.Errors.Message;
        args.Status = UpdateStatus.SkipCurrentRow;
    }
}

FillError (événement)

Le DataAdapter émet l'événement FillError en cas d'erreur pendant une opération Fill. Ce type d’erreur se produit généralement quand les données de la ligne ajoutée n’ont pas pu être converties en type .NET 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.

static DataSet DataAdapterFillAndError(SqlDataAdapter adapter)
{
    // Assuemes adapter is a valid SqlDataAdapter object.
    adapter.FillError += new FillErrorEventHandler(FillError);

    DataSet dataSet = new DataSet();
    adapter.Fill(dataSet);
    return dataSet;
}

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.  
        myRow.RowError =
           "OverflowException Encountered. Value from data source: " +
           args.Values[2];
        args.Continue = true;
    }
}

Voir aussi

• DataAdapters et DataReaders
• Événements
• Microsoft ADO.NET pour SQL Server