LinqDataSourceContextEventArgs.ObjectInstance Propriedade

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

Valor de Propriedade

O objeto de contexto de dados que definiu para a ObjectInstance propriedade; caso contrário, null. A predefinição é null.

Exemplos

O exemplo seguinte mostra como criar o objeto de contexto de dados chamando um construtor não sem parâmetros num gestor de eventos para o ContextCreating evento. O código atribui o objeto personalizado à ObjectInstance propriedade.

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

Observações

Por defeito, o controlo LinqDataSource cria uma instância da classe especificada na ContextTypeName propriedade. Faz isto chamando o construtor sem parâmetros dessa classe.

Pode criar manualmente o objeto para operações de dados, tratando o ContextCreating evento e definindo a ObjectInstance propriedade para um objeto que criou.

Crias o objeto manualmente se quiseres usar um construtor sem parâmetros ou se quiseres criar um objeto diferente daquele especificado na ContextTypeName propriedade.

A ObjectInstance propriedade não contém uma instância do tipo especificado na ContextTypeName propriedade, porque essa instância é criada após o ContextCreating evento. A ObjectInstance propriedade é usada apenas quando cria manualmente o objeto de contexto de dados durante o ContextCreating evento. Quando está a atualizar, inserir ou eliminar dados, deve definir a ObjectInstance propriedade para um objeto que deriva da DataContext classe.