LinqDataSourceContextEventArgs.ObjectInstance Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 .