Compartir a través de

Tutorial: Conectar a conjuntos de datos de ADO.NET

  • Artículo

Introducción

En este tutorial, aprenderá a conectar un informe de Crystal a un conjunto de datos ADO.NET, mediante un esquema del conjunto de datos. Son necesarios algunos pasos adicionales para elaborar un informe a partir de un conjunto de datos ADO.NET, ya que el informe no está conectado directamente a ninguna base de datos.

Un esquema del conjunto de datos ADO.NET proporciona una plantilla de la estructura de los datos en XML. Sin embargo, un informe no puede recuperar datos del esquema del conjunto de datos solo. En primer lugar, se debe crear una instancia de este conjunto de datos como instancia del conjunto de datos con tipos declarados o como instancia del conjunto de datos genérica. A continuación, la instancia del conjunto de datos se debe llenar con datos, mediante el uso de las clases DataAdapter.

En este tutorial, a causa de la complejidad agregada implicada en la elaboración de informes a partir de conjuntos de datos ADO.NET, los procesos que va a seguir para crear el esquema y llenar el conjunto de datos se mantienen separados del código de enlace de Crystal Reports.

Nota

Crystal Reports para Visual Studio proporciona una plantilla, denominada DataSet, para crear un esquema del conjunto de datos ADO.NET. En los sitios Web creados con Visual Studio 2005 y posterior, no se tiene acceso a esta plantilla desde el cuadro de diálogo Agregar nuevo elemento. Sólo está disponible la plantilla "Esquema XML" predeterminada. Sin embargo, con ajustes mínimos en el código (se explican en los pasos siguientes), puede utilizar la plantilla Esquema XML predeterminada para obtener los mismos resultados.

Para comenzar, va a crear una conexión de datos y a crear un esquema del conjunto de datos basado en esa conexión. A continuación, va a crear una clase auxiliar con una propiedad que devuelve una instancia del conjunto de datos llena. Finalmente, va a escribir código que enlace el informe de Crystal con el conjunto de datos.

En el código de enlace del informe de Crystal, va a escribir código para que se realicen las siguientes acciones:

  • Crear una instancia del informe.
  • Establecer el valor de la propiedad SetDataSource en el de la propiedad DataSet llena desde la clase auxiliar.
  • Enlazar el informe de Crystal Reports lleno al control CrystalReportViewer.

Finalmente, si está creando un sitio Web, va a colocar la instancia del conjunto de datos llena en un objeto ASP.NET Cache, para mejorar el rendimiento y la escalabilidad.

Se recomienda que los procesos de configuración del conjunto de datos y de enlazado del informe de Crystal sean independientes, tanto para mantener la claridad del código al enlazar el informe como para volver a utilizar el conjunto de datos en el proyecto Web o para Windows.

Código de ejemplo

Este tutorial incluye código de ejemplo de C# y Visual Basic que muestra la versión finalizada del proyecto. Siga las instrucciones de este tutorial para crear un nuevo proyecto o para abrir el proyecto de código de ejemplo y trabajar con una versión finalizada.

El código de ejemplo se almacena en carpetas que están clasificadas por idioma y tipo de proyecto. Los nombres de las carpetas de cada versión del código de ejemplo son los siguientes:

  • Sitio Web en C#: CS_Web_Data_DataSets
  • Proyecto para Windows en C#: CS_Win_Data_DataSets
  • Sitio Web en Visual Basic: VB_Web_Data_DataSets
  • Proyecto para Windows en Visual Basic: VB_Win_Data_DataSets

Para localizar las carpetas que contienen estos ejemplos, vea Directorio del código de ejemplo de los tutoriales.

En esta sección