Agregar y configurar los controles ReportViewer

Artículo
05/09/2011

Para agregar una o varias instancias de un control ReportViewer a una aplicación de Windows Forms o ASP.NET, arrastre dicho control desde la sección Informe del cuadro de herramientas a una página o un formulario de la aplicación. Puede utilizar el panel de etiquetas inteligentes y las propiedades para configurar el control y enlazar el informe. También puede escribir código si desea configurar el control mediante programación.

El control ReportViewer muestra un informe cada vez. Puede combinar varias instancias del control en la misma página o formulario si desea ver los informes simultáneamente. También puede utilizar una instancia única del control para hospedar un informe cada vez. Si desea utilizar una única instancia del control para mostrar una secuencia de informes, escriba código que asocie un informe con la instancia del control ReportViewer que desea utilizar.

Los controles ReportViewer trabajan tanto en modo de procesamiento local como en modo de procesamiento remoto.

En el modo de procesamiento local, el control abre una definición de informe, la procesa y luego presenta el informe en el área de la vista. En el modo de procesamiento local puede obtener la definición de informe de un archivo .rdlc en el sistema de archivos, o desde un recurso anidado de la aplicación. Para obtener más información, vea ReportPath, LoadReportDefinition y ReportEmbeddedResource.

En el modo de procesamiento remoto, el control recupera un informe totalmente procesado de un servidor de informes de Reporting Services. En el modo de procesamiento remoto, el procesamiento de los datos y el informe se lleva a cabo en el servidor de informes. El modo de procesamiento remoto se suele usar para los informes previamente publicados, pero también puede usarlo para procesar una definición de informe que se proporciona mediante un flujo. Para obtener más información, vea LoadReportDefinition, ReportServerUrl y ReportPath.

Importante
No puede utilizar archivos .rdlc en el modo de procesamiento remoto. El modo de procesamiento remoto requiere una copia con licencia de SQL Server 2008 o de una versión posterior de Reporting Services. El procesamiento remoto está diseñado para organizaciones que poseen un servidor de informes de SQL Server Reporting Services y que desean utilizar ese servidor junto con los controles. Una solución de servidor mejora la escalabilidad y el rendimiento, y ofrece características adicionales tales como suscripciones, almacenamiento en caché y más formatos de salida de informes. Para obtener más información acerca del modo de procesamiento remoto, vea Configurar ReportViewer para el procesamiento remoto e Implementar informes y controles ReportViewer.

No puede utilizar archivos .rdlc en el modo de procesamiento remoto. El modo de procesamiento remoto requiere una copia con licencia de SQL Server 2008 o de una versión posterior de Reporting Services. El procesamiento remoto está diseñado para organizaciones que poseen un servidor de informes de SQL Server Reporting Services y que desean utilizar ese servidor junto con los controles. Una solución de servidor mejora la escalabilidad y el rendimiento, y ofrece características adicionales tales como suscripciones, almacenamiento en caché y más formatos de salida de informes. Para obtener más información acerca del modo de procesamiento remoto, vea Configurar ReportViewer para el procesamiento remoto e Implementar informes y controles ReportViewer.

Cómo agregar y configurar un control ReportViewer

Agregue un formulario Windows Forms o Web Forms a un proyecto de .NET Framework 3.5 o 4.0.
En modo de diseño gráfico, arrastre el control ReportViewer del grupo Informe del Cuadro de herramientas al formulario Windows Forms o Web Forms. El control incluye un panel de etiquetas inteligentes Tareas de ReportViewer para que pueda seleccionar el informe inmediatamente.

El archivo web.config se actualiza automáticamente con el controlador HTTP para el control ReportViewer. Para obtener más información, vea Configuración de web.config para ReportViewer.

Nota

Para utilizar el control ReportViewer en un formulario Web Forms, también debe agregar un control ScriptManager a su página. En la ventana Cuadro de herramientas, en el grupo Extensiones AJAX, arrastre un control ScriptManager a la superficie de diseño, por encima del control ReportViewer.
En el panel de etiquetas inteligentes Tareas de ReportViewer, seleccione tareas para agregar un informe y configurar el control. La especificación del informe determina si el control se configura para procesamiento local o remoto.
- Haga clic en Diseñar nuevo informe para iniciar el Asistente para informes y crear un archivo de definición de informe (.rdlc) en la aplicación. Puede crear nuevos informes en la aplicación que se procesan localmente en el cliente. Para obtener más información acerca de la creación de informes, vea Crear archivos de definición de informe de cliente (.rdlc).
- Use Elegir informe para seleccionar una definición de informe existente. Puede elegir un archivo de definición de informe local (.rdlc) definido en el proyecto o puede elegir Informe de servidor para seleccionar un informe publicado en un servidor de informes de SQL Server 2008 Reporting Services.
  
  La selección de un informe de servidor configura el control para procesamiento remoto. Para seleccionar un informe de servidor, debe conocer la dirección URL del servidor de informes y la ruta de acceso al informe. Cuando se hace referencia a un informe en un servidor de informes en modo nativo, la ruta de acceso al informe comienza con una barra diagonal (/); si se hace referencia a un informe en un servidor de informes en modo integrado de SharePoint, la ruta de acceso al informe es una dirección URL completa. Por ejemplo:
  
  Modo nativo: /Adventureworks 2008 Sample Reports/Company Sales 2008
  
  Modo integrado de SharePoint: http://MyServer/sites/MySite/MyLibrary/Adventureworks 2008 Sample Reports/Company Sales 2008.rdl
  
  Para ejecutar el informe, debe tener permiso en el servidor de informes para obtener acceso al informe. Si no conoce la dirección URL o la ruta de acceso al informe, consulte con el administrador del servidor de informes. Para obtener más información acerca de los informes de servidor, vea Configurar ReportViewer para el procesamiento remoto.
  
  La selección de un archivo de definición de informe (.rdlc) existente configura el control para procesamiento local. Cuando elija un informe, deberá elegir un archivo .rdlc; no puede especificar un archivo .rdl aun cuando exista en el proyecto. Para obtener más información, vea Crear archivos de definición de informe de cliente (.rdlc).
- Haga clic en Acoplar en contenedor principal para expandir la superficie de la vista del control ReportViewer de manera que utilice todo el espacio disponible en el formulario o la página. Esta opción está disponible con el control de Windows Forms.
- Haga clic en Reenlazar orígenes de datos para actualizar enlaces de orígenes de datos para tablas de datos y objetos comerciales utilizados en el informe. Esta opción está disponible tras la selección de un informe para el control. Necesita reenlazar un origen de datos si modifica un origen de datos del informe o si modifica un elemento de informe enlazado a datos fuera del entorno de diseño gráfico del informe (por ejemplo, si edita el XML directamente).
Seleccione el control ReportViewer y abra la ventana Propiedades.
Establezca las propiedades en el control ReportViewer para determinar la visibilidad y disponibilidad de las áreas de visualización. Use la documentación de referencia para obtener más información sobre cada propiedad. Para obtener más información, vea Propiedades de ReportViewer. Para obtener información acerca de la barra de herramientas de ReportViewer, vea Configurar y utilizar la barra de herramientas de ReportViewer.
Compile o implemente la aplicación para obtener una vista previa del informe en el formulario o la página.