Aggiornamento e riassociazione di riferimenti all'origine dei dati (Progettazione report di Visual Studio)
Il controllo ReportViewer e il file di definizione del report del server (con estensione rdl) includono riferimenti alle origini dei dati che forniscono dati al report. Se si convertono le definizioni del report, si aggiunge o si elimina un set di dati oppure si elimina un set di dati utilizzato nel report, sarà necessario aggiornare tutti i riferimenti e le associazioni alle origini dei dati prima di distribuire o eseguire l'applicazione.
Panoramica sui riferimenti all'origine dei dati utilizzati in controlli e report di ReportViewer
Le informazioni relative alle origini dei dati possono essere utilizzate in modi diversi in controlli e report. In primo luogo, nella definizione del report vengono utilizzate informazioni incorporate sullo schema per definire l'associazione tra elementi nel layout del report e i dati uniti nel layout. In secondo luogo, per il controllo ReportViewer sono necessarie associazioni all'origine dei dati in modo da consentire il passaggio dei dati in fase di esecuzione.
In fase di esecuzione tutte le associazioni e le informazioni sull'origine devono essere sincronizzate. In caso contrario il report non conterrà i dati previsti. Sono disponibili numerose opzioni per garantire la sincronizzazione delle informazioni nelle varie fasi del ciclo di sviluppo e in particolare durante la modifica dei report e dei set di dati utilizzati nell'applicazione. Nell'elenco seguente sono riepilogate le diverse opzioni disponibili:
Utilizzare Scegli origini dei dati nel riquadro degli smart tag Attività di ReportViewer per associare un'origine dei dati a un file di definizione del report del client (con estensione rdlc) convertito da un file di definizione del report del server (con estensione rdl).
Utilizzare Riassocia origini dei dati nel riquadro degli smart tag Attività di ReportViewer per sincronizzare il controllo e la definizione del report con i set di dati modificati.
Utilizzare la finestra di dialogo Origini dei dati del report nel menu Report per aggiornare le informazioni sullo schema archiviate nel file di definizione del report. Il menu Report è disponibile quando si modifica un file di definizione del report del client (con estensione rdlc) in modalità progettazione grafica.
Aggiornamento dei riferimenti dell'origine dei dati in una definizione del report
La definizione del report include elementi del set di dati che consentono di definire la struttura dell'origine dei dati utilizzata nel report. Gli elementi del set di dati vengono aggiunti alla definizione del report durante la progettazione del report stesso. Viene inoltre aggiunto un nuovo elemento ogni volta che si trascina un campo specifico in un'area dati o in una casella di testo nel report.
L'aggiornamento della definizione del report risulta necessario se si intende copiare file di definizione del report tra progetti con origini dei dati diverse oppure se sono stati modificati i set di dati utilizzati nel progetto. Se si modifica successivamente il set di dati effettivo nel progetto, rimuovendo o rinominando campi o tabelle, la definizione del report non conterrà più riferimenti validi. Per aggiornare la definizione del report, utilizzare la finestra di dialogo Origini dei dati come descritto nelle operazioni seguenti.
Come aggiornare i riferimenti in una definizione del report
Aprire il file di definizione del report del client (con estensione rdlc) in modalità progettazione grafica.
Scegliere Origini dei dati dal menu Report. Verrà visualizzata la finestra di dialogo delle origini dei dati del report. È possibile utilizzare le opzioni seguenti:
Per aggiungere un nuovo set di dati alla definizione del report, selezionare un'origine dati del progetto e fare clic su Aggiungi a report. Nella maggior parte dei casi, questa opzione non è necessaria. Le origini dei dati del progetto vengono aggiunte automaticamente alla definizione del report quando si trascinano i campi nel layout del report.
Per rimuovere un riferimento al set di dati esistente dalla definizione del report, selezionare il set di dati e fare clic su Rimuovi.
Se un set di dati nel progetto è stato rinominato, è possibile utilizzare la finestra di dialogo Origini dei dati del report per aggiornare il nome del set di dati nella definizione del report. Fare clic su Rinomina per impostare il nome del set di dati in modalità sovrascrittura e quindi digitare il nuovo nome.
Fare clic su Aggiorna tutto per aggiornare il file di definizione del report in base alle modifiche apportate.
Riassociazione di origini dei dati al controllo ReportViewer
Per consentire l'accesso alle origini dei dati dell'applicazione in fase di esecuzione, è necessario definire associazioni dati nel controllo ReportViewer. Le associazioni dati vengono create per il controllo quando si seleziona un file di definizione del report del client (con estensione rdlc).
La riassociazione di un'origine dei dati risulta necessaria se si modifica una definizione del report già associata a un controllo, si modifica il set di dati dopo aver associato il controllo a un form o a una pagina Web oppure si aggiunge un nuovo set di dati al report. In tutti questi scenari le associazioni risultanti sono obsolete. Utilizzare Riassocia origini dei dati nel riquadro degli smart tag Attività di ReportViewer per aggiornare le associazioni dati nel codice dell'applicazione.
.gif) Nota |
|---|
Non è necessario riassociare un'origine dei dati per tutte le modifiche apportate a una definizione del report. La ridisposizione degli elementi, la formattazione degli elementi oppure il riutilizzo dello stesso campo con associazione a dati in più aree dati costituiscono esempi di modifiche che non invalidano associazioni dati esistenti. Analogamente, non sarà necessario aggiornare le associazioni se si modifica una parte dell'origine dei dati non utilizzata nel report. |
Come riassociare origini dei dati
Aprire il form o la pagina Web contenente il controllo ReportViewer.
Nel riquadro degli smart tag Attività di ReportViewer fare clic su Riassocia origini dei dati. È possibile esaminare il codice dietro il form o la pagina per confermare le modifiche.
Scelta delle origini dei dati per il controllo ReportViewer
Quando si converte un file di definizione del report del server (con estensione rdl) in un file di definizione del report del client (con estensione rdlc), è necessario verificare che l'applicazione includa il codice dell'associazione dati per il controllo ReportViewer. Tale codice viene generato automaticamente quando si crea un file con estensione rdlc da un modello di report. Il codice dell'associazione dati risulterà tuttavia mancante se il file con estensione rdlc viene creato in altro modo. Per aggiungere il codice dell'associazione dati, utilizzare Scegli origini dei dati nel riquadro degli smart tag Attività di ReportViewer. Per ulteriori informazioni sulla conversione di definizioni del report, vedere Conversione di file RDL e RDLC.
Come aggiungere associazioni all'origine dei dati
Aprire il form o la pagina Web contenente il controllo ReportViewer.
Nel riquadro degli smart tag Attività di ReportViewer fare clic su Scegli origini dei dati. È possibile esaminare il codice dietro il form o la pagina per confermare le modifiche.
Vedere anche
Concetti
Creazione di file di definizione del report client (con estensione rdlc)
Creazione di origini dei dati per un report
Utilizzo del riquadro degli smart tag delle attività di ReportViewer
Configurazione di ReportViewer per l'elaborazione locale