LinqDataSourceContextEventArgs.ObjectInstance Свойство

Определение

Возвращает или задает объект контекста данных.Gets or sets the data context object to create.

public:
 property System::Object ^ ObjectInstance { System::Object ^ get(); void set(System::Object ^ value); };
public object ObjectInstance { get; set; }
member this.ObjectInstance : obj with get, set
Public Property ObjectInstance As Object

Значение свойства

Объект контекста данных, присвоенный свойству ObjectInstance; в противном случае null.The data context object that you have set to the ObjectInstance property; otherwise, null. Значение по умолчанию — null.The default is null.

Примеры

В следующем примере показано, как создать объект контекста данных путем вызова конструктора без параметров в обработчике событий для ContextCreating события.The following example shows how to create the data context object by calling a non-parameterless constructor in an event handler for the ContextCreating event. Код присваивает пользовательскому объекту ObjectInstance свойство.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);
}
Protected Sub LinqDataSource_ContextCreating(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceContextEventArgs)
    e.ObjectInstance = New ExampleDataContext(ConfigurationManager.ConnectionStrings("ExampleConnectionString").ConnectionString)
End Sub

Комментарии

По умолчанию LinqDataSource элемент управления создает экземпляр класса, указанный ContextTypeName в свойстве.By default, the LinqDataSource control creates an instance of the class specified in the ContextTypeName property. Для этого вызывается конструктор без параметров этого класса.It does this by calling the parameterless constructor of that class.

Можно вручную создать объект для операций с данными, обрабатывая ContextCreating событие и ObjectInstance установив для свойства созданный объект.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.

Объект создается вручную, если требуется использовать конструктор без параметров или если требуется создать объект, отличный от указанного в ContextTypeName свойстве.You create the object manually if you want to use a non-parameterless constructor or if you want to create an object that is different from the one specified in the ContextTypeName property.

Свойство не содержит экземпляр типа, указанного ContextTypeName в свойстве, так как этот ContextCreating экземпляр создается после события. ObjectInstanceThe ObjectInstance property does not contain an instance of the type specified in the ContextTypeName property, because that instance is created after the ContextCreating event. Свойство используется только в том случае, если объект контекста данных создается вручную ContextCreating во время события. ObjectInstanceThe ObjectInstance property is used only when you manually create the data context object during the ContextCreating event. При обновлении, вставке или удалении данных необходимо задать ObjectInstance для свойства объект, производный DataContext от класса.When you are updating, inserting, or deleting data, you must set the ObjectInstance property to an object that derives from the DataContext class.

Применяется к