Configurar y utilizar la barra de herramientas de ReportViewer

Artículo
05/09/2011

Puede establecer propiedades en la ventana Propiedades o mediante código para configurar el control ReportViewer y la barra de herramientas de ReportViewer. Se pueden quitar o deshabilitar comandos específicos y establecer valores que se utilizan para inicializar la barra de herramientas. Para obtener más información acerca de las propiedades de los controles de servidor web ReportViewer, vea Propiedades de Microsoft.Reporting.WebForms.ReportViewer. Para obtener más información acerca de las propiedades de los controles de Windows Forms, vea Propiedades de Microsoft.Reporting.WinForms.ReportViewer.

Barra de herramientas de ReportViewer

El control ReportViewer incluye una barra de herramientas que proporciona funciones de navegación, búsqueda, exportación e impresión para que los usuarios puedan trabajar con informes en una aplicación implementada. Se pueden establecer propiedades en la barra de herramientas en el momento del diseño para controlar su aspecto y determinar la disponibilidad de las opciones de tiempo de ejecución. Si desea otra implementación de la barra de herramientas, puede crear una personalizada para reemplazar la predeterminada.

Barra de herramientas de ReportViewer

Nota

Debido a las diferencias de representación de los elementos de la interfaz de usuario en formato HTML y GDI (Graphics Design Instrumentation), la barra de herramientas de informe varía en función de si se utiliza el control de servidor web o el de Windows Forms.

Mapas del documento

Un mapa del documento es un área de navegación que contiene un lista de vínculos en los que los usuarios pueden hacer clic para navegar a un área determinada del informe. El mapa del documento es un cuadro de división contraíble situado a la izquierda del área de visualización de informes (o a la derecha en entornos en los que la lectura se realiza de derecha a izquierda). No todos los informes tienen un mapa del documento. Debe definir uno en la definición de informe si desea mostrarlo en el visor de informes. Para obtener más información acerca de los mapas del documento y otras características de informe interactivas, vea Agregar interactividad, visibilidad y navegación a un informe (Visual Studio Report Designer).

Navegar por un informe

La barra de herramientas de ReportViewer incluye una serie de funciones de navegación por las páginas. El usuario puede elegir una página específica o navegar directamente a la primera o a la última. Las páginas se determinan mediante saltos que se definen explícitamente en la definición de informe. Los saltos de página también se pueden calcular automáticamente, en función del formato de salida de informe que se utilice. Para obtener más información, vea Defining Page Size and Page Breaks in a ReportViewer Report.

Dado que, de forma predeterminada, el control ReportViewer de ASP.NET utiliza postbacks asincrónicos durante la interactividad, el usuario no podrá utilizar el botón Atrás del explorador, a menos que establezca la propiedad InteractivityPostBackMode en AlwaysSynchronous.

Para navegar por informes de obtención de detalles, el usuario puede utilizar el botón Volver al informe primario de la barra de herramientas de ReportViewer o el botón Atrás del explorador, siempre y cuando haya establecido la propiedad InteractivityPostBackMode convenientemente. Sin embargo, se recomienda que, a la hora de diseñar la aplicación, considere la inclusión de una opción de navegación; ello posibilitará el mantenimiento de la coherencia del estado de la sesión mientras el usuario navega por los informes de obtención de detalles. En caso contrario, el usuario puede recibir un mensaje de error sobre una llamada sin informe de obtención de detalles mientras navega por los informes de obtención de detalles. Para ayudar al usuario a mantener una única opción de navegación, puede:

Utilizar el modo AlwaysAsynchronous y establecer ShowBackButton en true.
Utilizar el modo AlwaysSynchronous o SynchronousOnDrillthrough y establecer ShowBackButton en false. Esto limitará al usuario al botón Atrás del explorador. Tenga presente que esta opción no aprovecha las ventajas de las características de AJAX del control de servidor web.

Detener y actualizar un informe

En el control de servidor web, el usuario puede hacer clic en el vínculo cancelar situado en el indicador de estado ocupado para cancelar la representación del informe. En el control de Windows Forms, el usuario puede hacer clic en el botón Detener situado en la barra de herramientas de ReportViewer para cancelar la representación del informe. El usuario puede utilizar el botón Actualizar para desencadenar la representación del informe.

Si el usuario hace clic en Actualizar para un servidor de informes, dicho servidor de informes volverá a procesar el informe con los datos más recientes. Tenga en cuenta que los datos más recientes están sujetos a las directivas de caché e instantáneas establecidas en el informe.

Si el usuario hace clic en Actualizar para un informe local, el comportamiento puede ser diferente. Dado que los informes procesados localmente utilizan datos que proporciona la aplicación, es probable que necesite actualizar el origen de datos durante las operación de actualización; para ello, deberá proporcionar código que controle el evento ReportViewer.ReportRefresh. Si no controla este evento en el control de Windows Forms, al hacer clic en Actualizar, se actualizará el informe con los datos antiguos de la aplicación. Para obtener más información acerca del evento ReportViewer.ReportRefresh en el control de servidor web, vea ReportRefresh. Para obtener más información acerca de la versión del control de Windows Forms, vea ReportRefresh.

Imprimir un informe

La barra de herramientas de ReportViewer admite la impresión. La compatibilidad con la impresión se implementa de forma distinta en cada versión del control ReportViewer. Es más, el control de servidor web solo proporciona compatibilidad con la impresión en Internet Explorer. Para obtener más información, vea Imprimir informes a partir de ReportViewer.

Ampliar o reducir la página de informe

La barra de herramientas de ReportViewer proporciona una funcionalidad de zoom estándar que permite acercar o alejar el informe. El control de servidor web solo proporciona compatibilidad con funcionalidad de zoom en Internet Explorer.

Realizar búsquedas en un informe

La barra de herramientas de ReportViewer incluye un campo de búsqueda que permite encontrar texto en un informe. Para realizar búsquedas de contenido en un informe, basta con escribir la palabra o frase que desee encontrar. La función de búsqueda distingue entre mayúsculas y minúsculas, y empieza en la página que se muestra actualmente. No se admiten los caracteres comodín ni los operadores de búsqueda booleanos. En una operación de búsqueda, sólo se incluye el contenido visible. Si se utiliza la funcionalidad de mostrar u ocultar en el informe, no se realizarán búsquedas en el texto oculto. Para buscar más apariciones del mismo valor, haga clic en Siguiente.

Exportar un informe

La barra de herramientas de ReportViewer proporciona formatos de exportación que permiten guardar un informe en un formato compatible. Un informe local se puede exportar a un archivo de Excel, PDF o de Word. Un informe de servidor se puede exportar a cualquier formato que admita el servidor de informes. Si utiliza el control de servidor web, puede establecer la propiedad ExportContentDisposition en el propio control para visualizar inmediatamente el informe exportado en Excel o en un programa de visualización de PDF en lugar de guardarlo como un archivo.

Un mismo informe puede tener un aspecto y una funcionalidad distintos en función del formato de representación seleccionado. Puede que los informes con vínculos, mapas de documento y marcadores no funcionen correctamente cuando se guarden en un archivo. En función del modo de alineación de los elementos de un informe, es posible que el diseño de este en un formato de archivo distinto incluya un número distinto de páginas o espacios en blanco adicionales. Para obtener más información, vea Exporting Reports en los Libros en pantalla de SQL Server.