Événements EntityDataSource
Mise à jour : novembre 2007
Les événements exposés par le contrôle EntityDataSource vous permettent d'ajouter davantage d'objets aux applications ASP.NET que dans les scénarios de balisage uniquement. Les gestionnaires d'événements permettent de valider les données, de fournir des valeurs aux propriétés qui ne sont pas liées aux données, d'extraire des informations sur les résultats des requêtes et de gérer le cycle de vie du ObjectContext utilisé pour interroger et mettre à jour des données.
Pour une description des événements dans les contrôles de source de données en général, consultez Tutorial 17: Examining the Events Associated with Inserting, Updating, and Deleting.
Événement |
Description |
|---|---|
L'événement ContextCreating fournit une instance ObjectContext qui doit être utilisée par le contrôle EntityDataSource pour les opérations suivantes. Pour plus d'informations, consultez Gestion du cycle de vie du contexte de l'objet. |
|
L'événement ContextCreated vous permet d'accéder à l'instance ObjectContext qui a été créée par le contrôle EntityDataSource. Cet objet de contexte peut être stocké et utilisé pour les opérations suivantes en dehors de EntityDataSource. Pour plus d'informations, consultez Gestion du cycle de vie du contexte de l'objet. |
|
L'événement ContextDisposing vous permet d'empêcher la suppression du ObjectContext utilisé par le contrôle EntityDataSource. Gérez cet événement si vous souhaitez utiliser une instance ObjectContext unique dans votre page pour plusieurs contrôles ou instances du contrôle EntityDataSource. |
|
L'événement Selecting vous permet de modifier la configuration du EntityDataSource et de lire ou de modifier les arguments du contrôle lié aux données avant la construction et l'exécution de la requête. Gérez cet événement si vous souhaitez modifier les comportements de pagination ou de tri du contrôle, ou annuler la requête. |
|
L'événement Selected vous permet d'accéder aux résultats d'une requête et d'extraire des informations sur le nombre de lignes. Gérez cet événement si vous souhaitez accéder aux résultats des objets ou stocker les objets dans l'état d'affichage. |
|
L'événement Inserting vous permet de modifier ou de vérifier l'objet ajouté, d'ajouter un autre objet ou d'annuler l'opération. Gérez cet événement pour accéder à l'objet à ajouter à partir de la propriété Entity de l'objet EntityDataSourceChangingEventArgs. |
|
L'événement Inserted vous permet d'accéder à un objet créé dans la source de données. La propriété Entity de l'objet EntityDataSourceChangedEventArgs permet d'accéder à l'objet ajouté. |
|
L'événement Updating vous permet de modifier ou de vérifier les modifications apportées à l'objet, de fournir un autre objet ou d'annuler l'opération avant que les modifications soient persistantes. Vous pouvez accéder à l'objet modifié à partir de la propriété Entity de l'objet EntityDataSourceChangingEventArgs. Gérez cet événement pour vérifier ou valider des modifications, ou pour modifier ObjectStateEntry afin que l'objet définisse des valeurs d'origine différentes pour le contrôle d'accès concurrentiel. Pour plus d'informations, consultez Enregistrement des modifications et gestion de l'accès concurrentiel (Entity Framework). |
|
L'événement Updated vous permet d'accéder à un objet dont les modifications viennent d'être persistantes dans la source de données. La propriété Entity de l'objet EntityDataSourceChangedEventArgs permet d'accéder à l'objet mis à jour. |
|
L'événement Deleting vous permet d'accéder à un objet avant qu'il soit supprimé de la source de données ou d'annuler l'opération. La propriété Entity de EntityDataSourceChangingEventArgs contient l'objet en cours de suppression. |
|
L'événement Deleted vous permet d'accéder à un objet qui a été supprimé de la source de données. La propriété Entity de l'objet EntityDataSourceChangingEventArgs permet d'accéder à l'objet supprimé. L'objet retourné est dans un état Detached. |
|
Exception() |
L'événement IDynamicDataSource.Exception est implémenté afin d'assurer la compatibilité avec Dynamic Data ASP.NET. Un gestionnaire de cet événement ne peut pas être enregistré dans le balisage. Il peut être uniquement utilisé lorsque l'instance de EntityDataSource est castée en une interface IDynamicDataSource. Pour plus d'informations, consultez Vue d'ensemble des modèles de données Dynamic Data ASP.NET. |
Voir aussi
Concepts
Gestion du cycle de vie du contexte de l'objet (EntityDataSource)
Configuration du contrôle EntityDataSource
Mise à jour des données (EntityDataSource)