LinqDataSourceContextEventArgs::ObjectInstance Property
Gets or sets the data context object to create.
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)
public: property Object^ ObjectInstance { Object^ get (); void set (Object^ value); }
Property Value
Type: System::ObjectThe data context object that you have set to the ObjectInstance property; otherwise, nullptr. The default is nullptr.
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.
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.