LinqDataSourceUpdateEventArgs Classe

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Fournit des données pour l'événement Updating.

public ref class LinqDataSourceUpdateEventArgs : System::ComponentModel::CancelEventArgs

public class LinqDataSourceUpdateEventArgs : System.ComponentModel.CancelEventArgs

type LinqDataSourceUpdateEventArgs = class
    inherit CancelEventArgs

Public Class LinqDataSourceUpdateEventArgs
Inherits CancelEventArgs

Héritage

Object

EventArgs

CancelEventArgs

LinqDataSourceUpdateEventArgs

Exemples

L’exemple suivant montre un gestionnaire d’événements pour l’événement Updating . L’exemple montre comment comparer les propriétés de la OriginalObject propriété et la NewObject propriété pour déterminer si la valeur de la Category propriété a changé. Dans ce cas, la CategoryChanged propriété de l’objet dans la NewObject propriété est définie sur true.

protected void LinqDataSource_Updating(object sender, LinqDataSourceUpdateEventArgs e)
{
    Product originalProduct = (Product)e.OriginalObject;
    Product newProduct = (Product)e.NewObject;

    if (originalProduct.Category != newProduct.Category)
    {
        newProduct.CategoryChanged = true;
    }
}

Protected Sub LinqDataSource_Updating(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceUpdateEventArgs)
    Dim originalProduct As Product
    Dim newProduct As Product

    originalProduct = CType(e.OriginalObject, Product)
    newProduct = CType(e.NewObject, Product)

    If (originalProduct.Category <> newProduct.Category) Then
        newProduct.CategoryChanged = True
    End If
End Sub

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

Protected Sub LinqDataSource_Updating(ByVal sender As Object, _
        ByVal e As LinqDataSourceUpdateEventArgs)
    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

protected void LinqDataSource_Updating(object sender,
        LinqDataSourceUpdateEventArgs 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;
    }
}

Remarques

L’objet LinqDataSourceUpdateEventArgs est transmis à n’importe quel gestionnaire d’événements pour l’événement Updating . Vous pouvez utiliser l’objet LinqDataSourceUpdateEventArgs pour examiner les données avant l’exécution de l’opération de mise à jour dans la source de données. Vous pouvez ensuite valider les données, examiner les exceptions de validation levées par la classe de données ou modifier une valeur avant la mise à jour. Vous pouvez également annuler l’opération de mise à jour.

L’objet OriginalObject contient les données qui ont été récupérées à l’origine à partir de la source de données. L’objet NewObject contient les données qui seront enregistrées dans la source de données pendant l’opération de mise à jour.

Si l’objet qui représente la source de données lève une exception de validation avant de mettre à jour les données, la Exception propriété contient une instance de la LinqDataSourceValidationException classe. Vous pouvez récupérer toutes les exceptions de validation via la InnerExceptions propriété. Si aucune exception de validation n’est levée, la Exception propriété contient null. Si vous gérez les exceptions de validation et que vous ne souhaitez pas que l’exception soit levée à nouveau, définissez la ExceptionHandled propriété truesur .

Par défaut, le contrôle stocke les valeurs d’origine de la source de données dans l’état d’affichage sur la page Web, à l’exception de celles dont l’attribut LinqDataSource est marqué comme UpdateCheck.Never.ColumnAttribute LINQ to SQL vérifie automatiquement l’intégrité des données avant de mettre à jour les données. Pour ce faire, comparez les valeurs actuelles de la source de données aux valeurs d’origine stockées dans l’état d’affichage. LINQ to SQL déclenche une exception si les valeurs de la source de données ont changé. Vous pouvez effectuer une validation de données supplémentaire en créant un gestionnaire pour l’événement Updating .

Constructeurs

Nom	Description
LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException)	Initialise une nouvelle instance de la LinqDataSourceUpdateEventArgs classe avec l’exception spécifiée.
LinqDataSourceUpdateEventArgs(Object, Object)	Initialise une nouvelle instance de la classe LinqDataSourceUpdateEventArgs.

Propriétés

Nom	Description
Cancel	Obtient ou définit une valeur indiquant si l’événement doit être annulé. (Hérité de CancelEventArgs)
Exception	Obtient l’exception levée pendant la validation des données avant l’opération de mise à jour.
ExceptionHandled	Obtient ou définit une valeur qui indique si l’exception a été gérée et qu’elle ne doit pas être levée à nouveau.
NewObject	Obtient l’objet qui contient les valeurs qui seront enregistrées dans la source de données.
OriginalObject	Obtient l’objet qui contient les valeurs qui ont été récupérées à l’origine à partir de la source de données.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• LINQ to SQL