Actualizar y reenlazar referencias de orígenes de datos (Diseñador de informes de Visual Studio)
El control ReportViewer y el archivo de definición de informe de cliente (.rdlc) incluyen referencias sobre los orígenes de datos que proporcionan datos al informe. Si convierte definiciones de informe, agrega o elimina un conjunto de datos, o modifica un conjunto de datos que se utiliza en un informe, debe actualizar la totalidad de las referencias de orígenes de datos y enlaces antes de implementar o ejecutar la aplicación.
Información general de las referencias de orígenes de datos que utilizan los informes y controles ReportViewer
Los controles e informes utilizan la información de orígenes de datos de diversas maneras. En primer lugar, la definición de informe utiliza información de esquema incrustado para asociar elementos del diseño del informe con los datos que finalmente se mezclan en el diseño. En segundo lugar, el control ReportViewer requiere enlaces de orígenes de datos para que pueda pasarle datos en tiempo de ejecución.
En tiempo de ejecución, todos los enlaces y la información de orígenes de datos deben estar en sincronización para que el informe contenga los datos esperados. Se proporcionan una variedad de opciones para ayudarle a mantener la información de orígenes de datos sincronizada a lo largo del ciclo de desarrollo, a medida que modifica los informes y conjuntos de datos que se utilizan en la aplicación. La lista siguiente resume las diferentes opciones disponibles:
Utilice la tarea Elegir orígenes de datos en el panel de etiquetas inteligentes Tareas de ReportViewer para enlazar un origen de datos con un archivo de definición de informe de cliente (.rdlc) que haya convertido a partir de un archivo de definición de informe de servidor (.rdl).
Utilice la tarea Reenlazar orígenes de datos en el panel de etiquetas inteligentes Tareas de ReportViewer para sincronizar el control y la definición de informe con conjuntos de datos modificados.
Utilice el cuadro de diálogo Orígenes de datos de informe del menú Informe para actualizar la información de esquema almacenada en el archivo de definición de informe. El menú Informe está disponible cuando edita un archivo de definición de informe de cliente (.rdlc) en modo de diseño gráfico.
Actualizar referencias de orígenes de datos en una definición de informe
La definición de informe incluye elementos de conjuntos de datos que definen la estructura de orígenes de datos que utiliza el informe. Los elementos de conjuntos de datos se agregan a la definición de informe durante el diseño de informe. Se agrega un nuevo elemento cada vez que arrastra un campo específico hasta una región de datos o cuadro de texto en el informe.
La actualización de la definición de informe es necesaria si está copiando archivos de definición de informe entre proyectos que tienen orígenes de datos diferentes o si modificó los conjuntos de datos utilizados en el proyecto. Si luego modifica el conjunto de datos real del proyecto quitando o cambiando el nombre de campos o tablas, la definición de informe ya no contendrá referencias válidas. Para actualizar la definición de informe, utilice el cuadro de diálogo Orígenes de datos como se describe en los pasos siguientes.
Cómo actualizar referencias en una definición de informe
Abra el archivo de definición de informe de cliente (.rdlc) en el modo de diseño gráfico.
En el menú Informe, seleccione Orígenes de datos. Aparece el cuadro de diálogo Orígenes de datos. Puede utilizar las opciones siguientes:
Para agregar un nuevo conjunto de datos a la definición de informe, seleccione un origen de datos de proyecto y haga clic en Agregar a Informe. En la mayoría de los casos, esta opción no es necesaria. Los orígenes de datos de proyecto se agregan a la definición de informe automáticamente al arrastrar campos hasta el diseño de informe.
Para quitar una referencia de conjunto de datos existente de la definición de informe, seleccione el conjunto de datos y haga clic en Quitar.
Si cambió el nombre de un conjunto de datos del proyecto, puede utilizar el cuadro de diálogo Orígenes de datos de informe para actualizar el nombre del conjunto de datos en la definición de informe. Haga clic en el botón Cambiar nombre para establecer el nombre del conjunto de datos en el modo de sobrescritura y luego escribir el nombre nuevo.
Haga clic en Actualizar todo para actualizar el archivo de definición de informe con los cambios.
Reenlazar orígenes de datos al control ReportViewer
El control ReportViewer requiere enlaces de datos para el acceso a orígenes de datos de la aplicación en tiempo de ejecución. Los enlaces de datos se crean para el control cuando selecciona un archivo de definición de informe de cliente (.rdlc).
El reenlace de un origen de datos es necesario si modifica una definición de informe que ya ha sido enlazada a un control, si modifica el conjunto de datos tras el enlace del control a un formulario o página web, o si agrega un nuevo conjunto de datos al informe. En todas estas situaciones, los enlaces quedan desactualizados. Utilice la tarea Reenlazar orígenes de datos del panel de etiquetas inteligentes Tareas de ReportViewer para actualizar los enlaces de datos en el código de la aplicación.
.gif) Nota |
|---|
No todas las modificaciones a una definición de informe requieren que reenlace un origen de datos. La reorganización de elementos, la asignación de formato a elementos o la reutilización del mismo campo enlazado de datos en varias regiones son ejemplos de modificaciones que no invalidan los enlaces de datos existentes. De igual manera, si modifica una parte del origen de datos que no se utiliza en el informe, no necesita actualizar los enlaces. |
Reenlazar orígenes de datos
Abra el formulario o la página web que contiene el control ReportViewer.
En el panel de etiquetas inteligentes Tareas de ReportViewer, haga clic en Reenlazar orígenes de datos. Puede inspeccionar el código del formulario o la página para confirmar los cambios.
Elegir orígenes de datos para el control ReportViewer
Cuando convierte un archivo de definición de informe de servidor (.rdl) en un archivo de definición de informe de cliente (.rdlc), debe asegurarse de que la aplicación incluya el código de enlace de datos para el control ReportViewer. El código de enlace de datos se genera automáticamente cuando crea un archivo .rdlc a partir de una plantilla de informe. Sin embargo, faltará el código de enlace de datos si crea el archivo .rdlc de alguna otra manera. Para agregar el código de enlace de datos, utilice la tarea Elegir orígenes de datos en el panel de etiquetas inteligentes Tareas de ReportViewer. Para obtener más información acerca de la conversión de definiciones de informe, vea Convertir archivos RDL y RDLC.
Cómo agregar enlaces de orígenes de datos
Abra el formulario o la página web que contiene el control ReportViewer.
En el panel de etiquetas inteligentes Tareas de ReportViewer, haga clic en Elegir orígenes de datos. Puede inspeccionar el código del formulario o la página para confirmar los cambios.
Vea también
Conceptos
Crear archivos de definición de informe de cliente (.rdlc)
Crear orígenes de datos para un informe
Utilizar el panel de etiquetas inteligentes Tareas de ReportViewer
Configurar ReportViewer para el procesamiento local