Tutorial: Usar solo procedimientos almacenados (C#)

Este tutorial proporciona un escenario completo básico de LINQ to SQL para acceder a los datos mediante la ejecución de procedimientos almacenados solamente. Este enfoque suelen utilizarlo los administradores de bases de datos para limitar el acceso al almacén de datos.

En este tutorial, utilizará dos métodos asignados a procedimientos almacenados en la base de datos de ejemplo Northwind: CustOrdersDetail y CustOrderHist. La asignación se produce al ejecutar la herramienta de línea de comandos SqlMetal para crear un archivo de C#. Para obtener más información, vea la sección Requisitos previos que se incluye posteriormente en este tutorial.

Este tutorial no se basa en Object Relational Designer. Los desarrolladores que usen Visual Studio también pueden utilizar Object Relational Designer para implementar funcionalidad de procedimiento almacenado. Consulte Herramientas de LINQ to SQL en Visual Studio.

Este tutorial se escribió con la configuración de desarrollo de Visual C#.

Requisitos previos

En este tutorial se requiere lo siguiente:

• Este tutorial utiliza una carpeta dedicada ("c:\linqtest7") que contiene los archivos. Cree esta carpeta antes de empezar el tutorial.

• Base de datos de ejemplo Northwind.

  Si no dispone de esta base de datos en el equipo de desarrollo, puede descargarla del sitio web de descargas de Microsoft. Para obtener instrucciones, consulte Descargar bases de datos de ejemplo. Después de haber descargado la base de datos, copie el archivo northwnd.mdf en la carpeta c:\linqtest7.

• Un archivo de código de C# generado a partir de la base de datos Northwind.

  Este tutorial se escribió utilizando la herramienta SqlMetal con la línea de comandos siguiente:

  sqlmetal /code:"c:\linqtest7\northwind.cs" /language:csharp "c:\linqtest7\northwnd.mdf" /sprocs /functions /pluralize

  Para obtener más información, vea SqlMetal.exe (Herramienta de generación de código).

Información general

Este tutorial se compone de seis tareas principales:

• Configurar la solución LINQ to SQL en Visual Studio.

• Agregar el ensamblado System.Data.Linq al proyecto.

• Agregar el archivo de código de la base de datos al proyecto.

• Crear una conexión con la base de datos.

• Configurar la interfaz de usuario.

• Ejecutar y probar la aplicación.

Crear una solución LINQ to SQL

En esta primera tarea, va a crear una solución de Visual Studio que contiene las referencias necesarias para compilar y ejecutar un proyecto de LINQ to SQL.

Para crear una solución LINQ to SQL

1. En el menú Archivo de Visual Studio, apunte a Nuevo y haga clic en Proyecto.

2. En el panel Tipos de proyecto del cuadro de diálogo Nuevo proyecto, haga clic en Visual C#.

3. En el panel Plantillas , haga clic en Aplicación de Windows Forms.

4. En el cuadro Nombre, escriba SprocOnlyApp.

5. En el cuadro Ubicación, compruebe dónde quiere almacenar los archivos del proyecto.

6. Haga clic en OK.

   Se abre el Diseñador de Windows Forms.

Agregar la referencia al ensamblado de LINQ to SQL

El ensamblado de LINQ to SQL no está incluido en la plantilla Aplicación de Windows Forms estándar. Tendrá que agregar el ensamblado como se explica en los pasos siguientes:

Para agregar System.Data.Linq.dll

1. En Explorador de soluciones, haga clic con el botón derecho en Referencias y luego haga clic en Agregar referencia.

2. En el cuadro de diálogo Agregar referencia, haga clic en .NET, en el ensamblado System.Data.Linq y, a continuación, en Aceptar.

   El ensamblado se agrega al proyecto.

Agregar el archivo de código de Northwind al proyecto

En este paso se asume que ha utilizado la herramienta SqlMetal para generar un archivo de código a partir de la base de datos de ejemplo Northwind. Para obtener más información, vea la sección Requisitos previos, anteriormente en este tutorial.

Para agregar el archivo de código de Northwind al proyecto

1. En el menú Proyecto , haga clic en Agregar elemento existente.

2. En el cuadro de diálogo Agregar elemento existente, vaya a la ubicación del archivo c:\linqtest7\northwind.cs y, a continuación, haga clic en Agregar.

   El archivo northwind.cs se agrega al proyecto.

Crear una conexión de base de datos

En este paso, definirá la conexión con la base de datos de ejemplo Northwind. En este tutorial se utiliza "c:\linqtest7\northwnd.mdf" como ruta de acceso.

Para crear la conexión a la base de datos

1. En el Explorador de soluciones, haga clic con el botón derechos Form1.cs y, a continuación, en Ver código.

2. Escriba el código siguiente en la clase Form1:

   Northwnd db = new Northwnd(@"c:\linqtest7\northwnd.mdf");
   

Configurar la interfaz de usuario

En esta tarea preparará una interfaz para que los usuarios puedan ejecutar procedimientos almacenados para tener acceso a los datos de la base de datos. En las aplicaciones que desarrolla con este tutorial, los usuarios pueden tener acceso a los datos de la base de datos únicamente mediante los procedimientos almacenados que están incrustados en la aplicación.

Para configurar la interfaz de usuario

1. Regrese al Diseñador de Windows Forms (Form1.cs[Design]).

2. En el menú Ver , haga clic en Cuadro de herramientas.

   Se abrirá el cuadro de herramientas.

   Nota

   Haga clic en el icono para ocultar automáticamente de forma que el cuadro de herramientas se mantenga abierto mientras realiza los demás pasos de esta sección.

3. Arrastre dos botones, dos cuadros de texto y dos etiquetas desde el cuadro de herramientas hasta Form1.

   Organice los controles como en la ilustración anexa. Expanda Form1 para que los controles tengan el espacio necesario.

4. Haga clic con el botón derecho en Label1 y, a continuación, haga clic en Propiedades.

5. Cambie la propiedad de texto de label1 a Enter OrderID:.

6. De la misma manera, para label2, cambie la propiedad de texto de label2 a Enter CustomerID:.

7. De la misma manera, cambie la propiedad de texto de button1 a Order Details.

8. Cambie la propiedad de texto para button2 a Order History.

   Amplíe los controles de botón para que todo el texto esté visible.

Para administrar los clics de botón

1. Haga doble clic en Order Details en Form1 para abrir el controlador de eventos button1 en el editor de código.

2. Escriba el código siguiente en el controlador button1:

   // Declare a variable to hold the contents of
   // textBox1 as an argument for the stored
   // procedure.
   string param = textBox1.Text;
   
   // Declare a variable to hold the results
   // returned by the stored procedure.
   var custquery = db.CustOrdersDetail(Convert.ToInt32(param));
   
   // Execute the stored procedure and display the results.
   string msg = "";
   foreach (CustOrdersDetailResult custOrdersDetail in custquery)
   {
       msg = msg + custOrdersDetail.ProductName + "\n";
   }
   if (msg == "")
       msg = "No results.";
   MessageBox.Show(msg);
   
   // Clear the variables before continuing.
   param = "";
   textBox1.Text = "";
   

3. Ahora, haga doble clic en button2 en Form1 para abrir el controlador button2.

4. Escriba el código siguiente en el controlador button2:

   // Comments in the code for button2 are the same
   // as for button1.
   string param = textBox2.Text;
   
   var custquery = db.CustOrderHist(param);
   
   string msg = "";
   foreach (CustOrderHistResult custOrdHist in custquery)
   {
       msg = msg + custOrdHist.ProductName + "\n";
   }
   MessageBox.Show(msg);
   
   param = "";
   textBox2.Text = "";
   

Probar la aplicación

Ha llegado el momento de probar la aplicación. Observe que su contacto con el almacén de datos se limita a las acciones que puedan realizar los dos procedimientos almacenados. Esas acciones son: devolver los productos incluidos para cualquier orderID que escriba o devolver un historial de los productos solicitados para cualquier CustomerID que escriba.

Para probar la aplicación

1. Presiona F5 para iniciar la depuración.

   Aparece Form1.

2. En el cuadro Enter OrderID, escriba 10249 y, a continuación, haga clic en Order Details.

   Un cuadro de mensaje muestra los productos incluidos en el pedido 10249.

   Haga clic en Aceptar para cerrar el cuadro de mensaje.

3. En el cuadro Enter CustomerID, escriba ALFKI y, a continuación, haga clic en Order History.

   Aparece un cuadro de mensaje con el historial de pedidos del cliente ALFKI.

   Haga clic en Aceptar para cerrar el cuadro de mensaje.

4. En el cuadro Enter OrderID, escriba 123 y, a continuación, haga clic en Order Details.

   Aparece un cuadro de mensaje con el texto "No results".

   Haga clic en Aceptar para cerrar el cuadro de mensaje.

5. En el menú Depurar, haga clic en Detener depuración.

   La sesión de depuración se cierra.

6. Cuando termine de experimentar, haga clic en Cerrar proyecto en el menú Archivo y guarde su proyecto cuando se le solicite.

Pasos siguientes

Puede mejorar este proyecto realizando algunos cambios. Por ejemplo, podría enumerar los procedimientos almacenados disponibles en un cuadro de lista y permitir que el usuario seleccione qué procedimientos debe ejecutar. También podría transmitir el resultado de los informes a un archivo de texto.

Consulte también

• Aprender con tutoriales
• Procedimientos almacenados