Share via


LinqDataSourceContextEventArgs.ObjectInstance Propriedade

Definição

Obtém ou define o objeto de contexto de dados a ser criado.

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 da propriedade

O objeto de contexto de dados que você definiu para a ObjectInstance propriedade; caso contrário, null. O padrão é null.

Exemplos

O exemplo a seguir mostra como criar o objeto de contexto de dados chamando um construtor sem parâmetros em um manipulador 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

Comentários

Por padrão, o LinqDataSource controle cria uma instância da classe especificada na ContextTypeName propriedade . Ele faz isso chamando o construtor sem parâmetros dessa classe.

Você pode criar manualmente o objeto para operações de dados manipulando o ContextCreating evento e definindo a ObjectInstance propriedade como um objeto que você criou.

Você cria o objeto manualmente se quiser usar um construtor sem parâmetros ou se quiser 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 , pois essa instância é criada após o ContextCreating evento. A ObjectInstance propriedade é usada somente quando você cria manualmente o objeto de contexto de dados durante o ContextCreating evento. Quando você estiver atualizando, inserindo ou excluindo dados, deverá definir a ObjectInstance propriedade como um objeto derivado da DataContext classe .

Aplica-se a