Crear orígenes de datos para un informe
Un archivo de definición de informe de cliente (.rdlc) incluye elementos de conjuntos de datos que definen la estructura de los orígenes de datos que utiliza el informe. Debe agregar uno o varios conjuntos de datos al informe antes de poder usar los datos en la definición de informe. Después de crear un conjunto de datos, puede arrastrar un campo específico hasta una región de datos o un cuadro de texto en el informe.
Los archivos de definición de informe del cliente (.rdlc) los procesa el control ReportViewer como informes locales. A diferencia de los informes de servidor, los informes locales requieren que se procesen los datos antes de que el control ReportViewer pueda procesar los informes. Los informes locales pueden utilizar datos procedentes de cualquier origen, siempre que puedan ser suministrados como un objeto DataTable o como una colección IEnumerable de objetos comerciales. La tabla de datos o el objeto comercial devuelve una lista de campos que pueden utilizarse para el informe. Cada campo contiene un puntero a un campo de base de datos y una propiedad de nombre, un campo de un origen de datos del objeto o una columna de una DataTable. Es posible arrastrar campos desde la ventana Datos de informe hasta la superficie de diseño del informe.
Configurar orígenes de datos en un proyecto
Se recomiendan los enfoques siguientes para configurar un DataSet o una enumeración IEnumerable de objetos comerciales como un origen de datos de informe. Después configurar un origen de datos, puede enlazar el DataSet o los objetos comerciales al informe.
Usar tablas de datos
Para crear una DataTable, utilice el comando Agregar nuevo elemento del menú Proyecto y seleccione el objeto DataSet. Arrastre un TableAdapter desde el cuadro de herramientas al Editor de DataSet para configurar la DataTable con el Asistente para la configuración de TableAdapter. El Asistente para la configuración de TableAdapter proporciona un generador de consultas y una característica de vista previa de datos para que pueda confirmar los resultados de la consulta inmediatamente.
Usar objetos Business
Un objeto Business es cualquier aplicación que expone propiedades públicas de tipos de datos simples. Por ejemplo, una matriz de objetos Título de libro creados por una aplicación es un objeto comercial que puede utilizarse como origen de datos para un informe.
Para que se pueda tener acceso a ella como origen de datos, una clase debe exponer un método o una propiedad que devuelve una enumeración IEnumerable. Puede agregar al proyecto una clase o una referencia al ensamblado de una clase.
Los pasos necesarios para usar objetos comerciales son distintos para los proyectos de Windows Forms y los de ASP.NET. Para obtener instrucciones sobre el uso de objetos de negocios en Windows Forms, consulte Tutorial: Usar un origen de datos de un objeto comercial con el control de Windows Forms de ReportViewer en el modo de procesamiento local. Para obtener instrucciones sobre el uso de objetos de negocios en ASP.NET, consulte Visita guiada: Usar un origen de datos de objeto comercial con el control de servidor web ReportViewer en el modo de procesamiento local.
Enlazar datos a un informe
Los archivos de definición de informe (.rdlc) están enlazados a objetos DataSet u objetos comerciales que contienen los datos que necesita. Cuando cree un informe utilizando el Asistente para informes, este le guiará por los pasos necesarios para crear un objeto DataSet con los datos que necesita y le permitirá enlazarlos al informe. También puede enlazar manualmente un objeto DataSet o un objeto comercial a un informe en la ventana Datos de informe. Esta ventana muestra todos los conjuntos de datos que están enlazados al informe, agrupados por objetos DataSet.
Para enlazar un conjunto de datos a un informe
En la ventana Datos de informe del Diseñador de informes, haga clic en Nuevo y, a continuación, seleccione Conjunto de datos.
En el cuadro de lista conjunto de datos, seleccione el objeto DataSet que creó. Para crear un nuevo DataSet, haga clic en Nuevo y complete el Asistente para la configuración de orígenes de datos que proporciona Visual Studio. Si ha creado un objeto comercial, seleccione Global para tener acceso al objeto comercial.
En el cuadro de lista Conjuntos de datos disponibles, seleccione los datos con los que desea enlazar. Este cuadro de lista muestra los objetos comerciales o DataTable disponibles.
En el cuadro Nombre, especifique un nombre para este conjunto de datos y, a continuación, haga clic en Aceptar.
Si modifica los esquemas del DataSet después de definir el informe, deberá actualizar los enlaces de datos en el informe y en el control. Para obtener más información, consulte Actualizar y reenlazar referencias de orígenes de datos.
El informe puede tener cualquier número de conjuntos de datos. Para ver la lista de conjuntos de datos que realmente se utilizan en un informe, seleccione Datos de informe en el menú Ver. Para ver el informe y los datos en la aplicación, debe compilar o implementar la aplicación para comprobar que el informe contiene los datos esperados. Para obtener más información sobre la configuración del control y la definición del diseño del informe, consulte Configurar ReportViewer para el procesamiento local y Crear archivos de definición de informe de cliente (.rdlc).
Si desea comenzar inmediatamente, use los tutoriales siguientes para aprender a agregar cada tipo de origen de datos a un proyecto:
Definir orígenes de datos para controles de servidor web ReportViewer
Los controles de origen de datos proporcionan compatibilidad para extraer el nivel de acceso a los datos de manera que los controles de una página web se enlacen a un origen de datos que, a su vez, se enlaza a los datos reales. Esto le permite cambiar con eficacia el origen de datos sin tener que reenlazar cada control a cada dato.
Durante el diseño de una página web, la sección Datos del cuadro de herramientas enumera los distintos controles de orígenes de datos, como SqlDataSource y XmlDataSource. Algunos controles de origen de datos proporcionan compatibilidad con memoria de página en páginas web y otros controles utilizan datos compartidos. Los informes no utilizan memoria de página y, por lo tanto, la mejor elección para un control de servidor web ReportViewer es utilizar el control ObjectDataSource. Este control proporciona un puente entre los objetos almacenados en memoria caché (DataTable o las colecciones de objetos comerciales) y el informe. Cuando se agrega un control ReportViewer a una página web, se agrega y configura automáticamente un control ObjectDataSource.
Vea también
Referencia
LocalReport.SubreportProcessing
LocalReport.SubreportProcessing
Conceptos
Configurar ReportViewer para el procesamiento remoto
Actualizar y reenlazar referencias de orígenes de datos
Información general sobre TableAdapter