Tutorial: Usar un origen de datos de base de datos con el control de servidor web ReportViewer en modo de procesamiento local

Artículo
07/31/2015

Este tutorial muestra cómo crear un informe para un sitio web ASP.NET y cómo agregar un control ReportViewer a una página web de manera que los usuarios puedan ver el informe.

Requisitos previos

Para usar este tutorial, debe tener acceso a la base de datos de ejemplo AdventureWorks2008.Para obtener más información, vea Tutorial: Instalar la base de datos AdventureWorks.

Lleve a cabo los siguientes pasos en su equipo para crear una página web de ASP.NET con un control ReportViewer configurado para ver un informe local.En este ejemplo, creará la aplicación en Microsoft Visual Basic.

Crear un nuevo sitio web

En el menú Archivo, seleccione Nuevo y haga clic en Sitio web.
En el cuadro de diálogo Nuevo sitio web, en el panel Plantillas instaladas, seleccione Visual Basic y, a continuación, elija Sitio web ASP.NET.
En el cuadro Ubicación, especifique un directorio de proyecto y haga clic en Aceptar.

Se abre el proyecto de sitio web.

Agregar un conjunto de datos para definir una conexión de datos y un DataTable

En el menú Sitio web, seleccione Agregar nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, seleccione Conjunto de datos y, a continuación, haga clic en Agregar.Cuando se le pregunte si desea agregar el elemento a la carpeta App_Code, haga clic en Sí.

Esto agrega un nuevo archivo XSD DataSet1.xsd al proyecto y abre el Diseñador de DataSet.
En la ventana Cuadro de herramientas, arrastre un control TableAdapter a la superficie de diseño.Esto inicia el Asistente para la configuración de TableAdapter.
En la página Elegir la conexión de datos, haga clic en Nueva conexión.
Si esta es la primera vez que crea un origen de datos en Visual Studio, verá la página Elegir origen de datos.En el cuadro Origen de datos, seleccione Microsoft SQL Server.
En el cuadro de diálogo Agregar conexión, realice los pasos siguientes:
- En el cuadro Nombre del servidor, especifique el servidor en el que se encuentra la base de datos AdventureWorks2008.
  
  La instancia de SQL Server Express predeterminada es (local)\sqlexpress.
- En la sección Conexión con el servidor, seleccione la opción que proporciona acceso a los datos.La opción predeterminada es Usar autenticación de Windows.
- En la lista desplegable Seleccione o escriba el nombre de la base de datos, haga clic en AdventureWorks2008.
- Haga clic en Siguiente.
Si especificó Usar autenticación de SQL Server en el paso anterior, elija entre incluir los datos confidenciales en la cadena o establecer la información en el código de la aplicación.
En la página Guardar 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 valor predeterminado AdventureWorks2008ConnectionString.Haga clic en Siguiente.
En la página Elija un tipo de comando, seleccione Usar instrucciones SQL y, a continuación, haga clic en Siguiente.
En la página Escriba una instrucción SQL, escriba la siguiente consulta Transact-SQL para recuperar datos de la base de datos AdventureWorks2008 y, a continuación, haga clic en Finalizar.
```
SELECT d.Name as Dept, s.Name as Shift, 
    e.BusinessEntityID as EmployeeID
FROM (HumanResources.Department d
INNER JOIN HumanResources.EmployeeDepartmentHistory e
    ON d.DepartmentID = e.DepartmentID)
INNER JOIN HumanResources.Shift s
    ON e.ShiftID = s.ShiftID
```
También puede hacer clic en el botón Generador de consultas y utilizar el Generador de consultas para crear la consulta y comprobarla con el botón Ejecutar consulta.Si la consulta no devuelve los datos esperados, es posible que esté utilizando una versión anterior de AdventureWorks.Para obtener más información acerca de la instalación de la versión AdventureWorks2008 de AdventureWorks, vea Tutorial: Instalar la base de datos AdventureWorks.
Ha completado la configuración de DataTable de ADO.NET como origen de datos del informe.En la página Diseñador de DataSet de Visual Studio, debería ver el DataTable que agregó (el nombre predeterminado es DataTable1), con la enumeración de las columnas resultantes de la definición de consulta.En el menú Datos, puede seleccionar Vista previa de datos y, a continuación, hacer clic en el botón Vista previa para comprobar los resultados de la consulta.
En la página Elija los métodos que se van a generar, haga clic en Finalizar.
Guarde el archivo.

Diseñar el informe con el Asistente para informes

Asegúrese de que en el Explorador de soluciones está seleccionado el sitio web de nivel superior.
Haga clic con el botón secundario en el sitio web y seleccione Agregar nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, seleccione Asistente para informes, escriba un nombre para el archivo de informe y, a continuación, haga clic en Agregar.

Esto inicia el Asistente para informes.
En la página Propiedades del conjunto de datos, en el cuadro Origen de datos, seleccione el DataSet que creó.

El cuadro Conjuntos de datos disponibles se actualiza automáticamente con el DataTable que creó.
Haga clic en Siguiente.
En la página Organizar campos, haga lo siguiente:
1. Arrastre Dept desde Campos disponibles hasta el cuadro Grupos de filas.
2. Arrastre Shift desde Campos disponibles hasta el cuadro Grupos de columnas.
3. Arrastre EmployeeID desde Campos disponibles hasta el cuadro Valores.
4. Haga clic en la flecha situada junto a Sum(EmplyeeID) y seleccione Recuento.
Haga clic en Siguiente dos veces y, a continuación, haga clic en Finalizar para cerrar el Asistente para informes.

De este modo, se crea el archivo .rdlc y, a continuación, se abre en el Diseñador de informes.El Tablix que ha diseñado se muestra ahora en la superficie de diseño.
Guarde el archivo .rdlc.

Agregar un control ReportViewer a la aplicación

En el Explorador de soluciones, haga clic con el botón secundario en el formulario web Default.aspx y seleccione Ver diseñador.
Abra la ventana del Cuadro de herramientas.En el grupo Extensiones AJAX, arrastre un control ScriptManager a la superficie de diseño.
Desde la ventana Cuadro de herramientas, en el grupo Informes, arrastre un control ReportViewer hasta la página situada debajo del control ScriptManager.
Si no está ya abierto el panel de etiquetas inteligentes Tareas de ReportViewer, haga clic en el glifo de etiqueta inteligente de la esquina superior derecha para abrirlo.En el cuadro Elegir informe, seleccione el informe que ha creado.

Cuando seleccione un informe, se crearán automáticamente las instancias de orígenes de datos que se utilizan en el informe.Se genera código para crear instancias de cada objeto DataTable (y su contenedor DataSet) y un control ObjectDataSource correspondiente a cada origen de datos utilizado en el informe.Este control de origen de datos se configura automáticamente.

Compilar y ejecutar la aplicación

Presione CTRL+F5 para ejecutar la página sin depuración o F5 para ejecutarla con depuración.

Como parte del proceso de generación, se compila el informe y se agregan a la Lista de tareas todos los errores encontrados (como los errores de sintaxis en las expresiones utilizadas en el informe).

La página web aparece en el explorador.El control ReportViewer muestra el informe.Puede utilizar la barra de herramientas para examinar el informe, ampliar o reducir la visualización y exportar a Excel.
Cierre el explorador.

Vea también

Referencia

ReportViewer.Drillthrough

LocalReport.SubreportProcessing