LinqDataSourceContextEventArgs.ObjectInstance Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Extensions.dll

Získá nebo nastaví objekt kontextu dat k vytvoření.

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

Hodnota vlastnosti

Object

Objekt kontextu dat, který jste nastavili na ObjectInstance vlastnost , nulljinak . Výchozí formát je null.

Příklady

Následující příklad ukazuje, jak vytvořit objekt kontextu dat voláním konstruktoru bez parametrů v obslužné rutině ContextCreating události pro událost. Kód přiřadí vlastní objekt vlastnosti ObjectInstance .

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

Poznámky

Ve výchozím nastavení LinqDataSource ovládací prvek vytvoří instanci třídy zadané ve ContextTypeName vlastnosti . Dělá to voláním konstruktoru bez parametrů této třídy.

Objekt pro operace s daty můžete vytvořit ručně tak, že se o událost pojí ContextCreating a vlastnost ObjectInstance nastavíte na objekt, který jste vytvořili.

Objekt vytvoříte ručně, pokud chcete použít konstruktor bez parametrů nebo pokud chcete vytvořit objekt, který se liší od objektu zadaného ContextTypeName ve vlastnosti .

Vlastnost ObjectInstance neobsahuje instanci typu zadaného ContextTypeName ve vlastnosti, protože tato instance je vytvořena po ContextCreating události. Vlastnost se ObjectInstance používá pouze v případě, že během ContextCreating události ručně vytvoříte objekt kontextu dat. Při aktualizaci, vkládání nebo odstraňování dat je nutné nastavit ObjectInstance vlastnost na objekt, který je odvozen z DataContext třídy .