LinqDataSourceContextEventArgs.ObjectInstance Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.Extensions.dll

Pobiera lub ustawia obiekt kontekstu danych do utworzenia.

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

Wartość właściwości

Object

Obiekt kontekstu danych, który został ustawiony na ObjectInstance właściwość ; w przeciwnym razie null. Wartość domyślna to null.

Przykłady

W poniższym przykładzie pokazano, jak utworzyć obiekt kontekstu danych przez wywołanie konstruktora bez parametrów w procedurze obsługi zdarzeń ContextCreating dla zdarzenia. Kod przypisuje obiekt niestandardowy do ObjectInstance właściwości.

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

Uwagi

Domyślnie kontrolka LinqDataSource tworzy wystąpienie klasy określonej we ContextTypeName właściwości. Robi to przez wywołanie konstruktora bez parametrów tej klasy.

Obiekt dla operacji danych można utworzyć ręcznie, obsługując ContextCreating zdarzenie i ustawiając ObjectInstance właściwość na utworzony obiekt.

Obiekt należy utworzyć ręcznie, jeśli chcesz użyć konstruktora bez parametrów lub jeśli chcesz utworzyć obiekt inny niż określony we ContextTypeName właściwości.

Właściwość ObjectInstance nie zawiera wystąpienia typu określonego we ContextTypeName właściwości, ponieważ to wystąpienie jest tworzone po zdarzeniu ContextCreating . Właściwość ObjectInstance jest używana tylko podczas ręcznego ContextCreating tworzenia obiektu kontekstu danych podczas zdarzenia. Podczas aktualizowania, wstawiania lub usuwania danych należy ustawić ObjectInstance właściwość na obiekt pochodzący z DataContext klasy.