Condividi tramite


Aggiunta e configurazione dei controlli ReportViewer

È possibile aggiungere una o più istanze di un controllo ReportViewer a un'applicazione Microsoft Windows o ASP.NET trascinando il controllo dalla sezione Dati della casella degli strumenti di Visual Studio a una pagina o un form dell'applicazione. È possibile utilizzare un pannello smart tag e le proprietà per configurare il controllo e associare il report. È anche possibile scrivere il codice se si desidera configurare il controllo a livello di programmazione.

Il controllo ReportViewer consente di visualizzare una definizione di report alla volta. Per visualizzare i report contemporaneamente, è possibile combinare più istanze del controllo sulla stessa pagina o form. È anche possibile utilizzare una singola istanza del controllo per più report purché venga visualizzato un solo report alla volta. Per visualizzare una sequenza di report mediante un singolo controllo, è necessario scrivere il codice che associa un report all'istanza del controllo ReportViewer da utilizzare.

I controlli ReportViewer possono essere utilizzati in modalità di elaborazione locale o remota.

In modalità di elaborazione locale il controllo apre una definizione del report, la elabora e quindi la carica nell'area di visualizzazione. In modalità di elaborazione locale è possibile ottenere la definizione del report da un file con estensione rdlc del file system, da un flusso o da una risorsa incorporata nell'applicazione. Per ulteriori informazioni, vedere ReportPath, LoadReportDefinition e ReportEmbeddedResource.

In modalità di elaborazione remota il controllo recupera un report completamente elaborato da un server di report di Microsoft SQL Server 2005 Reporting Services. In tale modalità, inoltre, il controllo ReportViewer viene utilizzato come visualizzatore e fornisce il supporto per l'interazione con un report. In modalità di elaborazione remota tutte le operazioni di elaborazione e rendering dei dati vengono eseguite nel server di report. Per l'elaborazione remota è necessario disporre di report pre-pubblicati. È possibile ottenere il report da un flusso oppure specificando l'URL dell'indirizzo del report. In modalità di elaborazione remota non è infine possibile utilizzare file con estensione rdlc. Per ulteriori informazioni, vedere LoadReportDefinition, ReportServerUrl e ReportPath.

NoteImportante

Per utilizzare la modalità di elaborazione remota, è necessario disporre di una copia con licenza di SQL Server 2005 Reporting Services. L'elaborazione remota è destinata a organizzazioni che dispongono di un server di report di SQL Server Reporting Services e desiderano utilizzare tale server unitamente ai controlli. Una soluzione basata su server garantisce maggior scalabilità e migliori prestazioni, offrendo inoltre funzionalità aggiuntive quali sottoscrizioni, caching e altri formati di output per i report. È importante sottolineare che l'elaborazione remota implica l'introduzione di alcune differenze visive e funzionali in un report. Per ulteriori informazioni sulla modalità di elaborazione remota, vedere Configurazione di ReportViewer per l'elaborazione remota e Distribuzione di report e controlli ReportViewer.

Come creare e configurare un controllo ReportViewer

  1. Aggiungere un Windows Form o una pagina Web al progetto.

  2. In modalità progettazione grafica trascinare il controllo ReportViewer dalla casella degli strumenti nel form o nella pagina Web. Il controllo ReportViewer è disponibile nel gruppo Dati della casella degli strumenti e include un riquadro degli smart tag Attività per la selezione immediata del report.

  3. Nel riquadro degli smart tag Attività di ReportViewer selezionare le attività per aggiungere un report e configurare il controllo. La specifica del report consente di determinare se il controllo è configurato per l'elaborazione locale o remota.

    • Fare clic su Progetta nuovo report per avviare Progettazione report e creare un file di definizione del report (con estensione rdlc) nell'applicazione. È possibile creare nell'applicazione nuovi report che vengono elaborati in locale nel client. Per ulteriori informazioni sulla creazione di report, vedere Creazione di file di definizione del report client (con estensione rdlc).

    • Utilizzare Scegli report per selezionare una definizione di report esistente. È possibile scegliere un file di definizione del report (con estensione rdlc) locale definito nel progetto oppure scegliere Server report per selezionare un report pubblicato in un server di report di SQL Server 2005 Reporting Services.

      La selezione di un report del server consente di configurare il controllo per l'elaborazione remota. Per selezionare un report del server, è necessario conoscere l'URL del server di report e il percorso del report. Il percorso del report deve iniziare con una barra (/). Per eseguire il report, è necessario disporre dell'autorizzazione sul server di report per l'accesso al report. Se non si conosce l'URL o il percorso del report, rivolgersi all'amministratore del server di report. Per ulteriori informazioni sui report del server, vedere Configurazione di ReportViewer per l'elaborazione remota.

      La selezione di un file di definizione del report (con estensione rdlc) esistente consente di configurare il controllo per l'elaborazione locale. Per la selezione di un report è necessario scegliere un file con estensione rdlc. Non è possibile specificare un file con estensione rdl anche se esistente nel progetto. Se si desidera utilizzare un file con estensione rdl, è necessario convertirlo. Per ulteriori informazioni, vedere Creazione di file di definizione del report client (con estensione rdlc) e Conversione di file RDL e RDLC.

    • Fare clic su Ancora nel contenitore padre per espandere l'area di visualizzazione del controllo ReportViewer in modo che utilizzi tutto lo spazio disponibile nel form o nella pagina. Questa opzione è disponibile con il controllo Windows Form.

    • Fare clic su Riassocia origini dei dati per aggiornare le associazioni alle origini dei dati per tabelle di dati e oggetti business utilizzati nel report. Questa opzione è disponibile dopo aver selezionato un report per il controllo. È necessario riassociare i dati se si modifica un'origine dei dati del report oppure un elemento del report con associazione a dati all'esterno dell'ambiente di progettazione grafica del report, ad esempio se si modifica direttamente il codice XML.

  4. Selezionare il controllo ReportViewer e aprire la finestra Proprietà.

  5. Impostare le proprietà nel controllo ReportViewer per determinare la visibilità e la disponibilità di aree di visualizzazione. Per informazioni sulle singole proprietà, vedere la documentazione di riferimento. Per ulteriori informazioni, vedere Proprietà ReportViewer. Per ulteriori informazioni sulla barra degli strumenti di ReportViewer, vedere Configurazione e utilizzo della barra degli strumenti di ReportViewer.

  6. Generare o distribuire l'applicazione per visualizzare l'anteprima del report nel form o nella pagina.

Vedere anche

Concetti

Utilizzo del riquadro degli smart tag delle attività di ReportViewer
Creazione di file di definizione del report client (con estensione rdlc)
Configurazione di ReportViewer per l'elaborazione locale
Configurazione di ReportViewer per l'elaborazione remota
Configurazione di sottoreport e report drill-through (Progettazione report di Visual Studio)
Controlli del server Web e Windows Form di ReportViewer

Altre risorse

Esempi e scenari