Creazione di origini dei dati per un rapporto

Articolo
07/31/2015

Un file di definizione del rapporto del client (con estensione rdlc) include elementi del set di dati che definiscono la struttura dell'origine dati utilizzata dal rapporto. È necessario aggiungere uno o più set di dati al rapporto prima di poter utilizzare i dati nella definizione del rapporto. Dopo avere creato un set di dati, è possibile trascinare un campo specifico in un'area dati o una casella di testo nel rapporto.

I file di definizione del rapporto del client (con estensione rdlc) vengono elaborati dal controllo ReportViewer come rapporti locali. A differenza dei rapporti del server, i dati devono essere elaborati prima che i rapporti possano essere elaborati dal controllo ReportViewer. I rapporti locali possono utilizzare dati di qualsiasi origine, purché questa possa essere fornita come DataTable o come raccolta IEnumerable di oggetti business. La tabella di dati o l'oggetto business restituisce un elenco di campi che possono essere utilizzati dal rapporto. Ogni campo contiene un puntatore a un campo del database e a una proprietà del nome, un campo in un'origine dati oggetto o una colonna in un oggetto DataTable. È possibile trascinare campi dalla finestra Dati rapporto nell'area di progettazione del rapporto.

Configurazione di origini dati in un progetto

Gli approcci indicati di seguito sono consigliati per la configurazione di un oggetto DataSet o un'enumerazione IEnumerable di oggetti business come origine dati del rapporto. Dopo che è stata configurata un'origine dati, è possibile associare l'oggetto DataSet o gli oggetti business al rapporto.

Utilizzo di tabelle di dati

Per creare un oggetto DataTable, scegliere Aggiungi nuovo elemento dal menu Progetto, quindi selezionare l'oggetto DataSet. Trascinare un oggetto TableAdapter dalla casella degli strumenti a Editor DataSet per configurare DataTable con la Configurazione guidata TableAdapter. La Configurazione guidata TableAdapter include un generatore delle query e una funzionalità di anteprima dei dati per la conferma immediata dei risultati delle query.

Utilizzo di oggetti business

Un oggetto business è un qualsiasi oggetto applicazione che espone proprietà pubbliche di tipi di dati semplici. Una matrice di oggetti Titolo del libro creata dall'applicazione, ad esempio, è un oggetto business che può essere utilizzato come origine dati per il rapporto.

Per essere accessibile come origine dati, una classe deve esporre un metodo o una proprietà che restituisce un oggetto IEnumerable. È possibile aggiungere una classe o un riferimento all'assembly per una classe al progetto.

I passaggi per l'utilizzo di oggetti business cambiano a seconda che si tratti di progetti Windows Form o ASP.NET. Per istruzioni sull'utilizzo degli oggetti business in Windows Form, vedere Procedura dettagliata: utilizzo di un'origine dei dati di oggetti business con il controllo Windows Form di ReportViewer in modalità di elaborazione locale. Per istruzioni sull'utilizzo degli oggetti business in ASP.NET, vedere Procedura dettagliata: utilizzo di un'origine dei dati di oggetti business con il controllo del server Web ReportViewer in modalità di elaborazione locale.

Associazione di dati a un rapporto

I file di definizione del rapporto (con estensione rdlc) vengono associati a oggetti DataSet o a oggetti business che contengono i dati necessari. Quando si crea un rapporto tramite la Creazione guidata rapporto, la procedura guidata include istruzioni dettagliate per creare un oggetto DataSet con i dati necessari e associarlo al rapporto. È inoltre possibile associare manualmente un oggetto DataSet o un oggetto business a un rapporto nella finestra Dati rapporto. In questa finestra vengono visualizzati tutti i set di dati associati al rapporto, raggruppati in base agli oggetti DataSet.

Per associare un set di dati a un rapporto

Nella finestra Dati rapporto di Progettazione rapporti fare clic su Nuovo, quindi selezionare Set di dati.
Nella casella di riepilogo Origine dati selezionare l'oggetto DataSet creato. Per creare un nuovo oggetto DataSet, fare clic su Nuovo e seguire i passaggi della Configurazione guidata origine dati inclusa in Visual Studio. Se è stato creato un oggetto business, selezionare globale per accedere all'oggetto business.
Nella casella di riepilogo Set di dati disponibili selezionare i dati a cui si desidera eseguire l'associazione. In questa casella di riepilogo vengono visualizzati l'oggetto DataTable o gli oggetti business disponibili.
Nella casella Nome specificare un nome per il set di dati, quindi scegliere OK.

Se successivamente si modificano gli schemi DataSet dopo che è stato definito il rapporto, sarà necessario aggiornare le associazioni dati nel rapporto e nel controllo. Per ulteriori informazioni, vedere Aggiornamento e riassociazione di riferimenti all'origine dati.

Nel rapporto è possibile includere qualsiasi numero di set di dati. Per visualizzare l'elenco dei set di dati effettivamente utilizzati da un rapporto, scegliere Dati rapporto dal menu Visualizza. Per visualizzare il rapporto e i relativi dati nell'applicazione, è necessario compilare o distribuire l'applicazione per verificare che il rapporto contenga i dati previsti. Per ulteriori informazioni sulla configurazione del controllo e la definizione del layout del report, vedere Configurazione di ReportViewer per l'elaborazione locale e Creazione di file di definizione del rapporto del client (con estensione rdlc).

Per iniziare subito, utilizzare le procedure dettagliate seguenti, che consentono di aggiungere ogni tipo di origine dati a un progetto:

Definizione di origini dati per controlli server Web ReportViewer

I controlli dell'origine dei dati supportano l'astrazione del livello di accesso ai dati consentendo l'associazione tra i controlli presenti in una pagina Web e un'origine dei dati, che a sua volta viene associata ai dati effettivi. In questo modo è possibile cambiare l'origine dati senza dover riassociare i singoli controlli ai singoli dati.

Quando si progetta una pagina Web, nella sezione Dati nella casella degli strumenti sono elencati numerosi controlli origine dati, tra cui SqlDataSource e XmlDataSource. Alcuni controlli dell'origine dei dati forniscono il supporto per la memoria a pagine nelle pagine Web, mentre altri utilizzano dati condivisi. Nei rapporti non viene utilizzata la memoria a pagine, pertanto per un controllo del server Web ReportViewer è preferibile utilizzare il controllo ObjectDataSource. Questo controllo offre un bridge tra oggetti della cache in memoria (DataTable o raccolte di oggetti business) e il rapporto. Quando si aggiunge un controllo ReportViewer a una pagina Web, viene automaticamente aggiunto e configurato un controllo ObjectDataSource.

Vedere anche

Riferimenti

ReportViewer.Drillthrough

LocalReport.SubreportProcessing

ReportViewer.Drillthrough

LocalReport.SubreportProcessing

Concetti

Configurazione di ReportViewer per l'elaborazione remota

Aggiornamento e riassociazione di riferimenti all'origine dati

Cenni preliminari sugli oggetti TableAdapter

Altre risorse

Esempi e procedure dettagliate