LinqDataSourceInsertEventArgs, classe

L'objet LinqDataSourceInsertEventArgs est passé à un gestionnaire d'événements pour l'événement Inserting. La propriété NewObject contient les données qui seront insérées.

Vous pouvez utiliser l'objet LinqDataSourceInsertEventArgs pour examiner les données avant d'exécuter l'opération d'insertion dans la source de données. Vous pouvez alors valider les données, examiner les erreurs de validation de la classe de données ou modifier une valeur avant la mise à jour. Vous pouvez également annuler l'opération d'insertion.

Si l'objet qui représente la source de données lève une exception de validation avant l'insertion des données, la propriété Exception contient une instance de la classe LinqDataSourceValidationException. Vous pouvez alors récupérer toutes les exceptions de validation par l'intermédiaire de la propriété InnerExceptions. Si aucune exception de validation n'est levée, la propriété Exception contient null. Si vous gérez les exceptions de validation et souhaitez qu'elles ne soient plus levées, affectez la valeur true à la propriété ExceptionHandled.

L'exemple suivant décrit un gestionnaire pour l'événement Inserting. L'objet de la propriété NewObject est casté à un type appelé Product. La propriété DateModified de l'objet Product a pour valeur la date et l'heure en cours.

protected void LinqDataSource_Inserting(object sender, LinqDataSourceInsertEventArgs e)
{
    Product product = (Product)e.NewObject;
    product.DateModified = DateTime.Now;
}

L'exemple suivant montre un gestionnaire d'événements pour l'événement Inserting. Il affiche tous les messages d'exception de validation à l'aide d'un contrôle Label.

Protected Sub LinqDataSource_Inserting(ByVal sender As Object, _
        ByVal e As LinqDataSourceInsertEventArgs)
    If (e.Exception IsNot Nothing) Then
        For Each innerException As KeyValuePair(Of String, Exception) _
               In e.Exception.InnerExceptions
            Label1.Text &= innerException.Key & ": " & _
                innerException.Value.Message + "<br />"
        Next
        e.ExceptionHandled = True
    End If
End Sub

[C#]

protected void LinqDataSource_Inserting(object sender, 
        LinqDataSourceInsertEventArgs e)
{
    if (e.Exception != null)
    {
        foreach (KeyValuePair<string, Exception> innerException in 
             e.Exception.InnerExceptions)
        {
        Label1.Text += innerException.Key + ": " + 
            innerException.Value.Message + "<br />";
        }
        e.ExceptionHandled = true;
    }
}

• AspNetHostingPermission 

  pour fonctionner dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal.

• AspNetHostingPermission 

  pour fonctionner dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal.

Windows Vista, Windows XP SP2, Windows Server 2003

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Référence

Autres ressources