LinqDataSourceContextEventArgs.ObjectInstance Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Ruft das Datenkontextobjekt ab, das erstellt werden soll, oder legt dieses fest.

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

Eigenschaftswert

Object

Das Datenkontextobjekt, auf das Sie auf die ObjectInstance-Eigenschaft festgelegt haben, andernfalls null. Der Standardwert ist null.

Beispiele

Das folgende Beispiel zeigt, wie das Datenkontextobjekt erstellt wird, indem ein nicht parameterloser Konstruktor in einem Ereignishandler für das ContextCreating Ereignis aufgerufen wird. Der Code weist der -Eigenschaft das ObjectInstance benutzerdefinierte Objekt zu.

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

Hinweise

Standardmäßig erstellt das LinqDataSource Steuerelement eine instance der klasse, die in der ContextTypeName -Eigenschaft angegeben ist. Dazu wird der parameterlose Konstruktor dieser Klasse aufgerufen.

Sie können das Objekt manuell für Datenvorgänge erstellen, indem Sie das ContextCreating Ereignis behandeln und die ObjectInstance Eigenschaft auf ein von Ihnen erstelltes Objekt festlegen.

Sie erstellen das Objekt manuell, wenn Sie einen nicht parameterlosen Konstruktor verwenden möchten oder wenn Sie ein Objekt erstellen möchten, das sich von dem in der ContextTypeName -Eigenschaft angegebenen Objekt unterscheidet.

Die ObjectInstance -Eigenschaft enthält keine instance des in der ContextTypeName -Eigenschaft angegebenen Typs, da diese instance nach dem ContextCreating Ereignis erstellt wird. Die ObjectInstance -Eigenschaft wird nur verwendet, wenn Sie das Datenkontextobjekt während des Ereignisses ContextCreating manuell erstellen. Wenn Sie Daten aktualisieren, einfügen oder löschen, müssen Sie die ObjectInstance -Eigenschaft auf ein Objekt festlegen, das von der DataContext -Klasse abgeleitet ist.