LinqDataSourceContextEventArgs.ObjectInstance Property


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

Gets or sets the data context object to create.

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

public object ObjectInstance { get; set; }

Property Value

Type: System.Object

The data context object that you have set to the ObjectInstance property; otherwise, null. The default is null.

By default, the LinqDataSource control creates an instance of the class specified in the ContextTypeName property. It does this by calling the default constructor of that class.

You can manually create the object for data operations by handling the ContextCreating event and setting the ObjectInstance property to an object you have created.

You create the object manually if you want to use a non-default constructor or if you want to create an object that is different from the one specified in the ContextTypeName property.

The ObjectInstance property does not contain an instance of the type specified in the ContextTypeName property, because that instance is created after the ContextCreating event. The ObjectInstance property is used only when you manually create the data context object during the ContextCreating event. When you are updating, inserting, or deleting data, you must set the ObjectInstance property to an object that derives from the DataContext class.

The following example shows how to create the data context object by calling a non-default constructor in an event handler for the ContextCreating event. The code assigns the custom object to the ObjectInstance property.

protected void LinqDataSource_ContextCreating(object sender, LinqDataSourceContextEventArgs e)
    e.ObjectInstance = new ExampleDataContext(ConfigurationManager.ConnectionStrings["ExampleConnectionString"].ConnectionString);

.NET Framework
Available since 3.5
Return to top