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

Artículo
07/31/2015

Este tutorial muestra cómo crear un informe en un proyecto de aplicación de Windows Forms y cómo agregar un control ReportViewer a un formulario de Windows Form de modo que los usuarios de la aplicación 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.

Siga estos pasos para agregar un informe a un proyecto de una aplicación de Windows Forms.En este ejemplo, creará la aplicación en Microsoft Visual Basic.

Crear un proyecto de aplicación Windows nuevo

Abra Visual Studio.En el menú Archivo, seleccione Nuevo y después seleccione Proyecto.
En el panel Plantillas instaladas, elija Visual Basic y, a continuación, elija Aplicación de Windows Forms.El nodo Visual Basic puede estar debajo de Otros lenguajes, dependiendo de la configuración de inicio de Visual Studio.
En el cuadro Nombre, escriba el nombre del proyecto: ReportWalkthrough.
En el cuadro Ubicación, escriba el directorio en el que desea guardar el proyecto o haga clic en Examinar para navegar hasta él.
Haga clic en Aceptar.

Se abrirá el Diseñador de Windows Forms, que mostrará Form1.vb del proyecto creado.

Definir una conexión de origen de datos y DataTable

En el menú Proyecto, seleccione Agregar nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, haga clic en DataSet.
Escriba un nombre para el conjunto de datos y haga clic en Agregar.Esto agrega un nuevo archivo de esquema XML al proyecto y abre el Diseñador de DataSet.El nombre predeterminado es DataSet1.xsd.
En el Diseñador de DataSet, abra el Cuadro de herramientas y arrastre un TableAdapter a la superficie de diseño de DataSet.Se abrirá 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 la página 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, elija AdventureWorks2008.
- Haga clic en Aceptar para regresar al asistente.
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.
Haga clic en Siguiente.
En la página Guardar cadena de conexión en el archivo de config. 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.
En la página Elija los métodos que se van a generar, haga clic en Finalizar.

En la superficie de diseño de DataSet, debería ver DataTable1 con las columnas resultantes de la consulta.

Diseñar el informe con el Asistente para informes

En el menú Proyecto, seleccione Agregar nuevo elemento.
En Agregar nuevo elemento, haga clic en Asistente para informes.
Escriba un nombre para el archivo de informe.De forma predeterminada, el nombre del informe es Report1.rdlc.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.

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

Abra el archivo Form1.vb en su proyecto en modo de diseño.
En la ventana Propiedades de formulario, expanda la propiedad Tamaño y, a continuación, establezca la propiedad Alto en 700.
Desde la sección Informes del cuadro de herramientas, arrastre el control ReportViewer hasta el formulario.
Abra el panel de etiquetas inteligentes del control ReportViewer haciendo clic en el glifo de etiqueta inteligente de la esquina superior derecha.Haga clic en la lista desplegable Elegir informe y seleccione el informe que acaba de crear.La selección de un informe hace que se creen automáticamente instancias de orígenes de datos utilizados en el informe.Se generará código para crear instancias de un DataSet (el contenedor ADO.NET de un DataTable), un componente TableAdapter y un objeto BindingSource correspondiente a cada origen de datos utilizado en el informe.
En el panel de apertura de etiquetas inteligentes, elija Acoplar en contenedor principal.

Compilar y ejecutar la aplicación

En el menú Compilar, haga clic en Generar ReportWalkthrough.Como parte del proceso de generación, se compilará el informe.Se anotarán algunos errores (como un error de sintaxis en una expresión utilizada en el informe) agregándolos a la Lista de tareas.
Presione F5 para ejecutar la aplicación y ver el informe en el formulario.

Vea también

Referencia

ReportViewer.Drillthrough

LocalReport.SubreportProcessing