Creazione di file di definizione del report client (con estensione rdlc)

Nel controllo ReportViewer è supportata una modalità di elaborazione locale che consente di eseguire file di definizione del report del client (con estensione rdlc) utilizzando la funzionalità incorporata di elaborazione del controllo. I report del client eseguiti in modalità di elaborazione locale possono essere facilmente creati nel progetto di applicazione. Per creare il report, sono disponibili quattro approcci:

  • È possibile creare un nuovo file di definizione del report del client (con estensione .rdlc) tramite la Creazione guidata report.

  • È possibile creare un nuovo file di definizione del report del client (con estensione .rdlc) in Visual Studio.

  • È possibile convertire un file di definizione report (estensione .rdl) esistente nel formato del file di definizione del report del client (estensione .rdlc) utilizzato in modalità di elaborazione locale.

  • È possibile generare una definizione del report a livello di programmazione.

Per utilizzare una definizione di report esistente, aggiungere un elemento del report al progetto di applicazione. Quando si seleziona Aggiungi nuovo elemento dal menu Progetto, è possibile scegliere il modello Report per creare un layout del report da un report vuoto. Per creare un nuovo report, fare clic su Progetta nuovo report durante la configurazione del controllo ReportViewer. Verrà aperto un report vuoto.

Come creare e visualizzare l'anteprima di un report locale

  1. In Microsoft Visual Studio 2008 aprire il progetto di applicazione o il sito Web.

  2. Creare le origini dei dati che si desidera utilizzare. È possibile utilizzare tabelle di dati oppure oggetti business definiti nei set di dati disponibili nel progetto. Per ulteriori informazioni, vedere Creazione di origini dei dati per un report.

  3. Creare un file di definizione del report (con estensione rdlc) da utilizzare nel progetto.

  4. Definire un layout del report mediante l'aggiunta nel report vuoto di tabelle, caselle di testo, matrici, elenchi o grafici della casella degli strumenti. Tali elementi sono denominati aree dati. Le aree dati sono associate alle origini dei dati. In particolare, viene eseguito il mapping di ciascuna cella di un'area dati a un campo dell'origine dei dati. Per ulteriori informazioni, vedere Aggiunta di aree dati a un report (Progettazione report di Visual Studio).

  5. Completare il report aggiungendo stile, formattazione, immagini, bordi, intestazioni, piè di pagina, ordinamento e altre funzionalità specifiche dei report. Per ulteriori informazioni, vedere Definizione di un layout del report (Progettazione report di Visual Studio).

  6. Selezionare il form o la pagina che conterrà il controllo.

  7. In modalità progettazione grafica aggiungere il controllo ReportViewer al form o alla pagina Web. Il controllo ReportViewer è disponibile nella sezione Dati della casella degli strumenti. Per ulteriori informazioni, vedere Aggiunta e configurazione dei controlli ReportViewer.

  8. Ridimensionare e posizionare il controllo nella pagina o nel form.

  9. Nel riquadro degli smart tag Attività di ReportViewer selezionare il file di definizione del report del client (con estensione rdlc) creato per associare il report al controllo. Per ulteriori informazioni sull'apertura del riquadro degli smart tag, vedere Utilizzo del riquadro degli smart tag delle attività di ReportViewer.

Per visualizzare l'anteprima del report, è possibile generare o distribuire l'applicazione. È possibile visualizzare l'anteprima di un report eseguendolo in un controllo ReportViewer. Non è disponibile una modalità di anteprima distinta esclusivamente per il file con estensione rdlc. Si noti che è possibile aprire e modificare la definizione del report in qualsiasi momento e quindi generare e distribuire l'applicazione per verificarne i risultati.

Aggiunta di un nuovo elemento del report a un progetto

Quando si aggiunge un nuovo elemento del report a un progetto, viene creato un report vuoto e al progetto viene aggiunto un file Report.rdlc. La definizione del report viene aperta in modalità progettazione grafica. Lo spazio dei nomi dell'oggetto del report viene aggiunto al progetto e i controlli del report disponibili vengono aggiunti alla casella degli strumenti.

Aggiunta di elementi a un report

È possibile creare agevolmente report semplici trascinando elementi del report, ad esempio caselle di testo, tabelle, grafici e immagini, in un'area di progettazione del report e impostando le proprietà per tali elementi.

Un report più complesso può includere parametri ed espressioni utilizzate per personalizzare l'output del report. Per ottenere, ad esempio, un report relativo all'analisi di mercato per un'azione specifica, è necessario aggiungere al report un parametro per la specifica del simbolo dell'azione. È possibile fornire nell'applicazione un'interfaccia utente per richiedere all'utente di specificare un valore per il parametro. I parametri possono essere passati alla query per specificare con maggior precisione criteri di selezione dei dati oppure possono essere utilizzati per filtrare un set di risultati in modo che nel report venga visualizzata solo una parte dei risultati. I valori dei parametri possono essere predefiniti e passati dall'applicazione oppure specificati dall'utente prima dell'esecuzione del report.

Le espressioni, scritte sempre in Microsoft Visual Basic, vengono utilizzate per aggregare dati o eseguire formattazione condizionale. Nei report è possibile includere anche codice personalizzato. È possibile incorporare codice personalizzato nel report oppure chiamare metodi su un assembly personalizzato incluso nell'applicazione. A differenza delle espressioni, il codice personalizzato può essere scritto anche in altri linguaggi.

Vedere anche

Concetti

Utilizzo del riquadro degli smart tag delle attività di ReportViewer
Creazione di origini dei dati per un report
Definizione di un layout del report (Progettazione report di Visual Studio)
Panoramica sui report (Visual Studio)
Distribuzione di report e controlli ReportViewer
Aggiunta e configurazione dei controlli ReportViewer
Creazione di definizioni del report client tramite Creazione guidata report di Visual Studio

Altre risorse

Esempi e scenari