Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

LinqDataSourceInsertEventArgs classe

 

Date de publication : novembre 2016

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

Espace de noms:   System.Web.UI.WebControls
Assembly:  System.Web.Extensions (dans System.Web.Extensions.dll)

System.Object
  System.EventArgs
    System.ComponentModel.CancelEventArgs
      System.Web.UI.WebControls.LinqDataSourceInsertEventArgs

public class LinqDataSourceInsertEventArgs : CancelEventArgs

NomDescription
System_CAPS_pubmethodLinqDataSourceInsertEventArgs(LinqDataSourceValidationException)

Initialise une nouvelle instance de la LinqDataSourceInsertEventArgs classe et spécifie l’exception fournie.

System_CAPS_pubmethodLinqDataSourceInsertEventArgs(Object)

Initialise une nouvelle instance de la classe LinqDataSourceInsertEventArgs.

NomDescription
System_CAPS_pubpropertyCancel

Obtient ou définit une valeur indiquant si l’événement doit être annulé.(Hérité de CancelEventArgs.)

System_CAPS_pubpropertyException

Obtient l’exception levée lors de la validation des données avant l’opération d’insertion.

System_CAPS_pubpropertyExceptionHandled

Obtient ou définit une valeur qui indique si l’exception a été gérée et qu’il ne doit être levée à nouveau.

System_CAPS_pubpropertyNewObject

Obtient l’objet qui contient les données à insérer.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

Le LinqDataSourceInsertEventArgs objet est passé à un gestionnaire d’événements pour le Inserting événement. Le NewObject propriété contient les données qui seront insérées.

Vous pouvez utiliser la LinqDataSourceInsertEventArgs objet pour examiner les données avant d’exécuter l’opération d’insertion dans la source de données. Vous pouvez ensuite 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 d’insérer les données, le 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, le 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 de nouveau, définissez les ExceptionHandled propriété true.

L’exemple suivant montre un gestionnaire pour le Inserting événement. L’objet à partir de la NewObject propriété est convertie en un type nommé Product. Le DateModified propriété de la Product objet est défini avec la date et heure actuelles.

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 le Inserting événement. Il affiche tous les messages d’exception de validation à l’aide un Label contrôle.

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;
    }
}

.NET Framework
Disponible depuis 3.5

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: