LinqDataSourceContextEventArgs.ObjectInstance Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.Extensions.dll

Obtiene o establece el objeto de contexto de datos que se va a crear.

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 propiedad

Object

Objeto de contexto de datos que se ha establecido en la propiedad ObjectInstance; de lo contrario, null. De manera predeterminada, es null.

Ejemplos

En el ejemplo siguiente se muestra cómo crear el objeto de contexto de datos mediante una llamada a un constructor sin parámetros en un controlador de eventos para el ContextCreating evento. El código asigna el objeto personalizado a la ObjectInstance propiedad .

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

Comentarios

De forma predeterminada, el LinqDataSource control crea una instancia de la clase especificada en la ContextTypeName propiedad . Para ello, llama al constructor sin parámetros de esa clase.

Puede crear manualmente el objeto para las operaciones de datos controlando el ContextCreating evento y estableciendo la ObjectInstance propiedad en un objeto que ha creado.

El objeto se crea manualmente si desea usar un constructor sin parámetros o si desea crear un objeto distinto del especificado en la ContextTypeName propiedad .

La ObjectInstance propiedad no contiene una instancia del tipo especificado en la ContextTypeName propiedad , porque esa instancia se crea después del ContextCreating evento . La ObjectInstance propiedad solo se usa cuando se crea manualmente el objeto de contexto de datos durante el ContextCreating evento. Al actualizar, insertar o eliminar datos, debe establecer la ObjectInstance propiedad en un objeto que deriva de la DataContext clase .