Distribuzione di report e controlli ReportViewer

È possibile distribuire liberamente report e controlli ReportViewer inclusi nell'applicazione. I requisiti di distribuzione variano notevolmente a seconda del tipo di controllo e dalla configurazione del report per l'elaborazione locale o remota. È possibile distribuire nella stessa applicazione report elaborati in locale e in remoto.

Ridistribuzione dei controlli ReportViewer

Il controllo ReportViewer ridistribuibile è un file autoestraente denominato ReportViewer.exe che include un file con estensione msi e altri file. Il file ReportViewer.exe è reperibile nel percorso seguente: C:\\Programmi\\Microsoft Visual Studio 8\\SDK\\v2.0\\BootStrapper\\Packages\\ReportViewer\\ReportViewer.exe.

Durante l'esecuzione di ReportViewer.exe i file seguenti vengono copiati nella cartella della Global Assembly Cache del computer di distribuzione.

File Descrizione

Microsoft.ReportViewer.Common

Fornisce una funzionalità di elaborazione principale comune al controllo del server Web e al controllo Windows Form di ReportViewer.

Microsoft.ReportViewer.ProcessingObjectModel

Espone il modello a oggetti report per consentirne l'accesso a livello di programmazione in fase di esecuzione tramite espressioni nella definizione del report.

Microsoft.ReportViewer.WebForms

Fornisce il controllo ReportViewer per le pagine ASP.NET.

Microsoft.ReportViewer.WinForms

Fornisce il controllo ReportViewer per le applicazioni Windows.

Esecuzione di ReportViewer.exe

La posizione in cui verrà eseguito ReportViewer.exe dipende dal tipo di controllo utilizzato.

  • In caso di applicazioni ASP.NET, eseguire ReportViewer.exe sul server Web che ospita l'applicazione.

  • In caso di applicazioni Windows Form, includere i controlli come prerequisito applicativo in modo che vengano installati automaticamente con l'applicazione. Per automatizzare questo passaggio, è possibile utilizzare il programma di avvio automatico:

    1. Aprire la pagina delle proprietà del progetto.

    2. Fare clic su Pubblica e quindi su Prerequisiti.

    3. Selezionare Visualizzatore report di Microsoft Visual Studio 2008 e quindi fare clic su OK.

    4. Pubblicare l'applicazione.

Durante l'installazione dell'applicazione viene verificato se ReportViewer è già installato nel computer locale. In caso contrario, verrà installato dal programma di installazione.

Distribuzione di versioni localizzate dei controlli ReportViewer

Il controllo ReportViewer include i language pack per dieci lingue di Visual Studio: cinese semplificato, cinese tradizionale, francese, tedesco, italiano, giapponese, coreano, portoghese (Brasile), russo e spagnolo. Per utilizzare una versione localizzata del controllo è necessario eseguire le operazioni seguenti:

  1. Eseguire ReportViewer.exe.

  2. Spostarsi nella cartella contenente il language pack da utilizzare. Le cartelle sono posizionate in <unità>:\Programmi\Microsoft SDKs\Windows\v6.0A\BootStrapper\Packages\ReportViewer\<lingua>.

  3. Eseguire ReportViewerLP.exe.

Per utilizzare altre lingue in un controllo ReportViewer è possibile implementare Microsoft.Reporting.WebForms.IReportViewerMessages o l'interfaccia Microsoft.Reporting.WinForms.IReportViewerMessages per creare descrizioni comandi e altro testo dell'interfaccia utente in una specifica lingua.

Rilevazione delle impostazioni della lingua del browser

Se il controllo del server Web ReportViewer è utilizzato per visualizzare i report in un'applicazione browser, impostare la lingua del thread in modo da fornire un'interfaccia utente che corrisponda alle impostazioni linguistiche del browser. La lingua del thread non è impostata in base alle informazioni di intestazione fornite dal client in ASP.NET. Per adeguare l'applicazione alle impostazioni linguistiche del browser è possibile impostare System.Threading.Thread.CurrentCulture e System.Threading.Thread.CurrentUICulture nel codice dell'applicazione. Per ulteriori informazioni sull''utilizzo delle impostazioni linguistiche nell'applicazione, vedere System.Globalization.CultureInfo.

Considerazioni sulla distribuzione per il controllo del server Web ReportViewer

La distribuzione di un'applicazione ASP.NET in una Web farm implica ulteriori operazioni di configurazione per garantire il mantenimento dello stato di visualizzazione nell'ambito della farm. Se si intende distribuire il controllo del server Web ReportViewer in un ambiente di Web farm, è consigliabile specificare l'elemento machineKey nel file Web.config dell'applicazione. Per ulteriori informazioni, vedere Impostazioni di Web.config per ReportViewer.

I report elaborati nel controllo del server Web ReportViewer prevedono requisiti variabili per il browser. I problemi di compatibilità del browser possono rendere indisponibili alcuni tipi di funzionalità del report. Per ulteriori informazioni, vedere Supporto del browser per controlli del server Web ReportViewer.

Distribuzione di report

A meno che i file di definizione del report del client (con estensione rdlc) non vengano generati in modo dinamico in fase di esecuzione, i report elaborati in locale vengono archiviati nel file system in file con estensione rdlc e devono essere inclusi nell'applicazione. Tali file possono essere installati nell'unità disco oppure compilati nell'eseguibile dell'applicazione.

I report elaborati in un server remoto vengono archiviati in un server di report di Microsoft SQL Server 2005 Reporting Services. Non è invece necessario includere nell'applicazione i file dei report in quanto i report vengono elaborati in remoto e non sono disponibili nel sistema locale. Per distribuire report pubblicati in un server di report, è necessario fornire accesso continuativo a un server di report e accertarsi che gli utenti dell'applicazione dispongano delle autorizzazioni per visualizzare i report su tale server. Per distribuire report del server è necessario conoscere il funzionamento dell'estensione per l'autenticazione utilizzata dal server e il modello di autorizzazione basata sui ruoli per l'accesso al contenuto e alle operazioni. Per ulteriori informazioni, vedere Considerazioni sulla distribuzione di report del server.

Vedere anche

Concetti

Aggiunta e configurazione dei controlli ReportViewer
Impostazioni di Web.config per ReportViewer
Configurazione di ReportViewer per il rendering asincrono
Configurazione e utilizzo della barra degli strumenti di ReportViewer