EntityDataSource.ContextCreating Event


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Occurs when the EntityDataSource creates the ObjectContext that is used to work with entity data objects.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web.Entity (in System.Web.Entity.dll)

member ContextCreating : IEvent<EventHandler<EntityDataSourceContextCreatingEventArgs>,

Handle the ContextCreating event to supply your own ObjectContext instead of having a new ObjectContext created. If the ContextCreating event is not handled or the handler does not provide an ObjectContext, the EntityDataSource creates one according to its configuration. When an ObjectContext is provided to the ContextCreating event, the same instance is assigned to the Context property of the event object of successive events. For more information, see Object Context Life-Cycle Management (EntityDataSource). For more information about the object context, see Identity Resolution, State Management, and Change Tracking.

The following example shows how to create an ObjectContext variable of the Page object and assign it to the Context property of the EntityDataSourceContextCreatingEventArgs object.

public partial class _Default : System.Web.UI.Page
        AdventureWorksModel.AdventureWorksEntities objCtx =
            new AdventureWorksModel.AdventureWorksEntities();

        protected void EntityDataSource2_ContextCreating(object sender, 
            EntityDataSourceContextCreatingEventArgs e)
            e.Context = objCtx;

.NET Framework
Available since 3.5
Return to top