Lección 2: Definición de una conexión de datos y una tabla de datos para el informe primario

Después de crear un proyecto de sitio Web nuevo con la plantilla de sitio Web ASP.NET para Visual C#, el paso siguiente consiste en crear una conexión de datos y una tabla de datos para el informe primario.

Los ejemplos de código de Transact-SQL de este artículo utilizan la base de datos de ejemplo AdventureWorks2022 o AdventureWorksDW2022, que se puede descargar desde la página principal de Ejemplos y proyectos de la comunidad de Microsoft SQL Server.

Define una conexión de datos y una tabla de datos agregando un DataSet (para el informe primario)

1. En el menú Sitio web , seleccione Agregar nuevo elemento.

2. En el cuadro de diálogo Agregar nuevo elemento, selecciona DataSet y haz clic en Agregar. Cuando se te pida, debes agregar el elemento a la carpeta App_Code haciendo clic en Sí.

   Esta acción agrega un nuevo archivo XSD DataSet1.xsd al proyecto y abre el Diseñador de DataSet.

3. En la ventana del Cuadro de herramientas, arrastre un control TableAdapter hasta la superficie de diseño. Esta acción inicia el Asistente para configuración de TableAdapter.

4. En la página Elegir la conexión de datos , haga clic en Nueva conexión.

5. Si es la primera vez que creas un origen de datos en Visual Studio, verás la página Elegir origen de datos. En el cuadro Origen de datos , seleccione Microsoft SQL Server.

6. En el cuadro de diálogo Agregar conexión , realice los pasos siguientes:

   1. En el cuadro Nombre del servidor , escriba el servidor donde se encuentra la base de datos AdventureWorks2022.

      La instancia de SQL Server Express predeterminada es (local)\sqlexpress.

   2. En la sección Iniciar sesión en el servidor , seleccione la opción que proporciona acceso a los datos. Usar autenticación de Windows es el valor predeterminado.

   3. En la lista desplegable Seleccione o escriba un nombre de base de datos , haga clic en AdventureWorks2022.

   4. Selecciona OK y a continuación Siguiente.

7. Si ha seleccionado Usar autenticación de SQL Server en el paso 6 (b), seleccione la opción si quiere incluir la información confidencial en la cadena o establecer la información en su código de aplicación.

8. En la página Guardar la cadena de conexión en el archivo de configuración de la aplicación , escriba el nombre de la cadena de conexión o acepte el predeterminado AdventureWorks2022ConnectionString. Seleccione Siguiente.

9. En la página Elegir un tipo de comando, selecciona Usar instrucciones SQL y después haz clic en Siguiente.

10. En la página Escriba una instrucción SQL, escriba la siguiente consulta de Transact-SQL para recuperar los datos de la base de datos AdventureWorks2022 y seleccione Siguiente.

    SELECT ProductID, Name, ProductNumber, SafetyStockLevel, ReorderPoint FROM  Production.Product Order By ProductID  
    

    También puedes crear la consulta si haces clic en Generador de consultasy, después, comprobar la consulta seleccionando Ejecutar consulta.

11. En la página Elegir los métodos que se van a generar , asegúrese de desactivar Crear métodos para enviar actualizaciones directamente a la base de datos (GenerateDBDirectMethods)y seleccione Finalizar.

    Advertencia

    Asegúrese de desactivar Crear métodos para enviar actualizaciones directamente a la base de datos (GenerateDBDirectMethods)

    Has completado la configuración del objeto DataTable de ADO.NET como origen de datos para el informe. En la página del Diseñador de Dataset en Visual Studio, debería ver el objeto DataTable que agregó, con las columnas especificadas en la consulta. DataSet1 contiene los datos de la tabla Product, según la consulta.

12. Guarde el archivo.

13. Para obtener una vista previa de los datos, selecciona Vista previa de los datos en el menú Datos y haz clic en Vista previa.

Paso siguiente

Has creado correctamente una conexión de datos y una tabla de datos para el informe primario. Después, diseñarás el informe primario mediante el Asistente para informes. Consulta Lección 3: Diseño del informe primario mediante el Asistente para informes.