Cómo: Asignar procedimientos almacenados para realizar actualizaciones, inserciones y eliminaciones (Diseñador relacional de objetos)

Artículo
10/07/2008

Actualización: November 2007

Los procedimientos almacenados se pueden agregar al Diseñador relacional de objetos y ejecutar como métodos de DataContext normales. Se pueden usar también con el fin de invalidar el comportamiento predeterminado de LINQ to SQL en tiempo de ejecución para realizar inserciones, actualizaciones y eliminaciones cuando se guardan los cambios de las clases de entidad en una base de datos (por ejemplo, cuando se llama al método SubmitChanges).

Nota:
Si el procedimiento almacenado devuelve valores que se deben devolver al cliente (por ejemplo, los valores calculados en el procedimiento almacenado), cree parámetros de salida en los procedimientos almacenados. Si no puede usar parámetros de salida, escriba una implementación de método parcial en lugar de confiar en las invalidaciones generadas por el Diseñador relacional de objetos. Los miembros asignados a los valores generados por la base de datos deben establecerse en valores adecuados después de que se ejecuten correctamente las operaciones de INSERCIÓN o ACTUALIZACIÓN. Para obtener más información, consulte Responsabilidades del desarrollador en la invalidación del comportamiento predeterminado (LINQ to SQL).

Si el procedimiento almacenado devuelve valores que se deben devolver al cliente (por ejemplo, los valores calculados en el procedimiento almacenado), cree parámetros de salida en los procedimientos almacenados. Si no puede usar parámetros de salida, escriba una implementación de método parcial en lugar de confiar en las invalidaciones generadas por el Diseñador relacional de objetos. Los miembros asignados a los valores generados por la base de datos deben establecerse en valores adecuados después de que se ejecuten correctamente las operaciones de INSERCIÓN o ACTUALIZACIÓN. Para obtener más información, consulte Responsabilidades del desarrollador en la invalidación del comportamiento predeterminado (LINQ to SQL).

Nota:
LINQ to SQL procesa automáticamente los valores generados por la base de datos para columnas identidad (incremento automático), rowguidcol (GUID generado por la base de datos) y columnas con marca de tiempo. Los valores generados por la base de datos de otros tipos de columna producirán inesperadamente un valor nulo. Para devolver los valores generados por la base de datos, debería establecer manualmente IsDbGenerated en true, y AutoSync en una de las siguientes opciones: Always, OnInsert o OnUpdate.

LINQ to SQL procesa automáticamente los valores generados por la base de datos para columnas identidad (incremento automático), rowguidcol (GUID generado por la base de datos) y columnas con marca de tiempo. Los valores generados por la base de datos de otros tipos de columna producirán inesperadamente un valor nulo. Para devolver los valores generados por la base de datos, debería establecer manualmente IsDbGenerated en true, y AutoSync en una de las siguientes opciones: Always, OnInsert o OnUpdate.

Configurar el comportamiento de actualización de una clase de entidad

De forma predeterminada, el motor en tiempo de ejecución LINQ to SQL proporciona la lógica para actualizar una base de datos (inserciones, actualizaciones y eliminaciones) con los cambios realizados en los datos de las clases de entidad de LINQ to SQL. El motor en tiempo de ejecución crea comandos predeterminados de inserción, actualización y eliminación basándose en el esquema de la tabla (información de columna y de clave principal). Cuando no se desea usar el comportamiento predeterminado, se puede configurar el comportamiento de actualización asignando procedimientos almacenados concretos para realizar las inserciones, actualizaciones y eliminaciones necesarias para poder manipular los datos en la tabla. También se puede realizar esta acción cuando no se genera el comportamiento predeterminado, por ejemplo, cuando las clases de entidad se asignan a vistas. Por último, se puede invalidar el comportamiento de actualización predeterminado cuando la base de datos requiere el acceso a las tablas a través de procedimientos almacenados.

Nota:
Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Valores de configuración de Visual Studio.

Para asignar procedimientos almacenados con el fin de invalidar el comportamiento predeterminado de una clase de entidad

Abra el archivo de LINQ to SQL en el diseñador. (Haga doble clic en el archivo .dbml en el Explorador de soluciones.)
En el Explorador de servidores/Explorador de bases de datos, expanda Procedimientos almacenados y busque los procedimientos almacenados que desee usar para los comandos Insertar, Actualizar y/o Eliminar de la clase de entidad.
Arrastre el procedimiento almacenado hasta el Diseñador relacional de objetos.

El procedimiento almacenado se agrega al panel de métodos como un método de DataContext. Para obtener más información, vea Métodos DataContext (Diseñador relacional de objetos).
Seleccione la clase de entidad para la que desee usar el procedimiento almacenado para realizar las actualizaciones.
En la ventana Propiedades, seleccione el comando que desee invalidar (Insertar, Actualizar o Eliminar).
Haga clic en los puntos suspensivos (...) junto a Usar motor en tiempo de ejecución para abrir el cuadro de diálogo Configurar comportamiento.
Seleccione Personalizar.
Seleccione el procedimiento almacenado que desee en la lista Personalizar.

Examine la lista de Argumentos de método y Propiedades de clase para comprobar que los Argumentos de método se asignan a las Propiedades de clase adecuadas. Asigne los argumentos de método originales (Original_nombreDeArgumento) a las propiedades originales (nombreDePropiedad (Original)) de los comandos Actualizar y Eliminar.

Nota:
De forma predeterminada, los argumentos de método se asignan a las propiedades de clase cuando los nombres coinciden. Si los nombres de propiedad modificados ya no coinciden entre la tabla y la clase de entidad, puede que tenga que seleccionar la propiedad de clase equivalente para la asignación si el diseñador no puede determinar la asignación correcta.

Haga clic en Aceptar o en Aplicar.

Nota:
Puede continuar configurando las combinaciones de clase y comportamiento haciendo clic en Aplicar después de realizar cada modificación. Si cambia la clase o el comportamiento antes de hacer clic en Aplicar, aparecerá un cuadro de diálogo de advertencia en el que podrá aplicar los cambios.

Para revertir a la lógica predeterminada del motor en tiempo de ejecución para las actualizaciones, haga clic en los puntos suspensivos junto a los comandos Insertar, Actualizar o Eliminar en la ventana Propiedades y, a continuación, seleccione Usar motor en tiempo de ejecución en el cuadro de diálogo Configurar comportamiento.

Vea también

Cómo: Asignar procedimientos almacenados para realizar actualizaciones, inserciones y eliminaciones (Diseñador relacional de objetos)

Configurar el comportamiento de actualización de una clase de entidad

Para asignar procedimientos almacenados con el fin de invalidar el comportamiento predeterminado de una clase de entidad

Vea también

Tareas

Conceptos

Otros recursos

Recursos adicionales