Esercitazione: Connessione ai DataSet ADO.NET

  • Articolo

Introduzione

In questa esercitazione viene descritto come connettere un report Crystal a un DataSet ADO.NET mediante uno schema DataSet. Per la creazione di un report da un DataSet ADO.NET sono necessari alcuni passaggi aggiuntivi, poiché il report non è connesso direttamente a un database.

Uno schema DataSet ADO.NET fornisce un modello della struttura dati in XML. Tuttavia, un report non può recuperare i dati solo dallo schema DataSet. Innanzitutto è necessario creare un'istanza dello schema DataSet come istanza DataSet con tipizzazione forte o generica, quindi compilare l'istanza di dati mediante l'utilizzo delle classi DataAdapter.

In questa esercitazione, a causa della complessità della creazione di report da DataSet ADO.NET, i processi da seguire per creare lo schema e compilare il DataSet sono tenuti rigorosamente separati dal codice di collegamento di Crystal Reports.

NoteNota

Crystal Reports per Visual Studio offre un modello, denominato DataSet, per creare uno schema DataSet ADO.NET. Nei siti·Web creati con Visual Studio 2005 e versioni successive, il modello DataSet non è accessibile dalla finestra di dialogo Aggiungi nuovo elemento. ed è disponibile solo il modello predefinito "Schema XML". Tuttavia, con alcune piccole modifiche al codice (descritte nei passaggi riportati di seguito), è possibile utilizzare il modello predefinito Schema XML per ottenere gli stessi risultati.

Iniziare creando una connessione dati e uno schema DataSet basato su di essa. Quindi, creare una classe di supporto con una proprietà che restituisca un'istanza compilata del DataSet. Infine, scrivere il codice di collegamento del report Crystal al DataSet.

Nel codice di collegamento del report Crystal, inserire le istruzioni per effettuare le seguenti operazioni:

  • Creare un'istanza del report.
  • Impostarne la proprietà SetDataSource sulla proprietà DataSet compilata della classe di supporto.
  • Collegare il report Crystal compilato al controllo CrystalReportViewer.

Infine, se si sta creando un sito Web, inserire l'istanza DataSet compilata nell'oggetto Cache ASP.NET per migliorare le prestazione e la scalabilità.

Si consiglia di tenere distinti il processo di configurazione del DataSet e quello di collegamento del report Crystal, per garantire chiarezza nel codice quando si collega il report e consentire di riutilizzare il DataSet nel sito Web o nel progetto Windows.

Codice di esempio

Ciascuna esercitazione viene fornita con un codice di esempio in linguaggio Visual Basic e C# che illustra la versione completa del progetto. Seguire le istruzioni riportate in questa esercitazione per creare un nuovo progetto o aprire il progetto del codice di esempio per utilizzare una versione completa.

Il codice di esempio si trova in cartelle classificate per lingua e tipo di progetto. I nomi delle cartelle per ciascuna versione di codice di esempio sono i seguenti:

  • Sito Web in C#: CS_Web_Data_DataSets
  • Progetto Windows C#: CS_Win_Data_DataSets
  • Sito Web in Visual Basic: VB_Web_Data_DataSets
  • Progetto Visual Basic Windows: VB_Win_Data_DataSets

Per individuare le cartelle contenenti questi esempi, vedere Directory del codice di esempio delle esercitazioni.

Contenuto della sezione: