Métodos DataContext (Diseñador relacional de objetos)

Artículo
10/07/2008

Actualización: November 2007

Los métodos de DataContext (en el contexto del Diseñador relacional de objetos (Diseñador R/O)) son métodos de la clase DataContext que ejecutan procedimientos almacenados y funciones en una base de datos.

La clase DataContext es una clase de LINQ to SQL que actúa como una vía entre una base de datos de SQL Server y las clases de entidad de LINQ to SQL asignadas a esa base de datos. La clase DataContext contiene la información de la cadena de conexión y los métodos para realizar la conexión a una base de datos y manipular los datos de la base de datos. De forma predeterminada, la clase DataContext contiene varios métodos a los que se puede llamar, como el método SubmitChanges que envía los datos actualizados de las clases de LINQ to SQL a la base de datos. También se pueden crear métodos adicionales de DataContext que se asignan a los procedimientos almacenados y funciones. Es decir, al llamar a estos métodos personalizados, se ejecutará el procedimiento almacenado o la función en la base de datos a la que está asignado el método de DataContext. Se pueden agregar métodos nuevos a la clase DataContext de la misma forma que se agregarían métodos para extender cualquier clase. Sin embargo, en las explicaciones sobre los métodos de DataContext en el contexto del Diseñador relacional de objetos, se abordan los métodos de DataContext que se asignan a los procedimientos almacenados y funciones.

Nota:
En LINQ to SQL, los procedimientos almacenados y funciones se administran de la misma manera, ya que ambos se asignan a las clases de entidad usando el mismo atributo StoredProcedureAttribute. En el contexto de LINQ to SQL, los métodos de DataContext que se asignan a los procedimientos almacenados son los mismos que los que se asignan a las funciones.

Panel de métodos

Los métodos de DataContext que se asignan a los procedimientos almacenados y funciones se muestran en el panel de métodos del Diseñador relacional de objetos. El panel de métodos es el panel situado junto al panel Entidades (la principal superficie de diseño). El panel de métodos muestra todos los métodos de DataContext creados mediante el Diseñador relacional de objetos. De forma predeterminada, el panel de métodos está vacío; arrastre los procedimientos almacenados o funciones desde el Explorador de servidores/Explorador de bases de datos hasta el Diseñador relacional de objetos para crear métodos de DataContext y rellenar el panel de métodos. Para obtener más información, consulte Cómo: Crear métodos DataContext asignados funciones y procedimientos almacenados (Diseñador relacional de objetos).

Nota:
Para abrir y cerrar el panel de métodos, haga clic con el botón secundario del mouse en el Diseñador relacional de objetos y, a continuación, haga clic en Ocultar panel Métodos o Mostrar panel Métodos, o bien, use el método abreviado de teclado CTRL+1.

Dos tipos de métodos de DataContext

Los métodos de DataContext son los que se asignan a los procedimientos almacenados y funciones de la base de datos. Puede crear y agregar métodos DataContext en el panel de métodos de Diseñador relacional de objetos. Hay dos tipos distintos de métodos de DataContext: los que devuelven uno o varios conjuntos de resultados y los que no:

Métodos de DataContext que devuelven uno o varios conjuntos de resultados:

Cree este tipo de método de DataContext cuando la aplicación solamente necesite ejecutar los procedimientos almacenados y funciones en la base de datos y devolver los resultados. Para obtener más información, vea Cómo: Crear métodos DataContext asignados funciones y procedimientos almacenados (Diseñador relacional de objetos), [T:System.Data.Linq.ISingleResult'1] e IMultipleResults.
Métodos de DataContext que no devuelven conjuntos de resultados, como Inserts, Updates y Deletes para una clase de entidad concreta.

Cree este tipo de método de DataContext cuando la aplicación tenga que ejecutar los procedimientos almacenados en lugar de usar el comportamiento predeterminado de LINQ to SQL para guardar los datos modificados entre una clase de entidad y la base de datos. Para obtener más información, consulte Cómo: Asignar procedimientos almacenados para realizar actualizaciones, inserciones y eliminaciones (Diseñador relacional de objetos).

Tipos de valor devuelto de los métodos de DataContext

Al arrastrar los procedimientos almacenados y funciones desde el Explorador de servidores/Explorador de bases de datos hasta el Diseñador relacional de objetos, el tipo de valor devuelto del método generado de DataContext difiere según la ubicación donde se coloque el elemento. Al colocar directamente los elementos en una clase de entidad existente, se crea un método de DataContext con el tipo de valor devuelto de la clase de entidad; al colocar los elementos en un área vacía (en cualquiera de los dos paneles) del Diseñador relacional de objetos, se crea un método de DataContext que devuelve un tipo generado automáticamente. El tipo generado automáticamente coincide con el nombre del procedimiento almacenado o de la función y sus propiedades se asignan a los campos devueltos por el procedimiento almacenado o la función.

Nota:
Se puede cambiar el tipo de valor devuelto de un método de DataContext después de agregarlo al panel de métodos. Para examinar o cambiar el tipo de valor devuelto de un método de DataContext, selecciónelo y fíjese en la propiedad Tipo devuelto en la ventana Propiedades. Para obtener más información, consulte Cómo: Cambiar el tipo devuelto de un método DataContext (Diseñador relacional de objetos).

Se puede cambiar el tipo de valor devuelto de un método de DataContext después de agregarlo al panel de métodos. Para examinar o cambiar el tipo de valor devuelto de un método de DataContext, selecciónelo y fíjese en la propiedad Tipo devuelto en la ventana Propiedades. Para obtener más información, consulte Cómo: Cambiar el tipo devuelto de un método DataContext (Diseñador relacional de objetos).

Los objetos que se arrastran desde la base de datos a la superficie del Diseñador relacional de objetos reciben automáticamente un nombre basado en el nombre de los objetos de la base de datos. Si arrastra el mismo objeto más de una vez, se anexa un número al final del nuevo nombre para diferenciar los nombres. Cuando los nombres de objetos de la base de datos contienen espacios o caracteres no admitidos en Visual Basic o C#, el espacio o el carácter no válido se sustituye por un carácter de subrayado.