This documentation is archived and is not being maintained.

EntityDataSource::ContextCreating Event

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)

 event EventHandler<EntityDataSourceContextCreatingEventArgs^>^ ContextCreating {
	void add (EventHandler<EntityDataSourceContextCreatingEventArgs^>^ value);
	void remove (EventHandler<EntityDataSourceContextCreatingEventArgs^>^ value);
<asp:EntityDataSource OnContextCreating="EventHandler" />

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 (Entity Framework).

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

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.