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)

public event EventHandler<EntityDataSourceContextCreatingEventArgs> ContextCreating
<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 Object Services Overview (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;

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

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

.NET Framework

Supported in: 3.5 SP1