Aggiunta di immagini a un report (Progettazione report di Visual Studio)

Un'immagine è un elemento del report che include un riferimento a un'immagine archiviata nel server di report, incorporata all'interno del report o archiviata in un database. Può essere rappresentata da un logo o da un'immagine presente una sola volta nel report oppure da un'immagine ripetuta con le righe di dati. È inoltre possibile utilizzare un'immagine come sfondo per determinati elementi del report. Per ottenere immagini, utilizzare le seguenti origini:

• Database

• Sito Web o condivisione di file esterna

• Immagini incorporate in locale nel report

Non è possibile utilizzare file immagine aggiunti a un progetto.

È possibile visualizzare le immagini associate ai dati da dati binari archiviati in un database. Le immagini visualizzate unitamente ai nomi di prodotti in un catalogo costituiscono un esempio di immagini di database.

Le immagini esterne sono specificate sotto forma di URL che punta a un file immagine. Le immagini esterne sono particolarmente adatte per logo e immagini statiche condivisi tra più report o pagine Web.

Le immagini di report locali sono incorporate nel report e quindi aggiunte tramite riferimento. I dati dell'immagine vengono archiviati all'interno della definizione del report e non sono disponibili in un file distinto. Le immagini incorporate assicurano che le immagini siano sempre disponibili per il report, ma non è possibile condividerle. L'utilizzo di un'immagine incorporata comporta un aumento delle dimensioni del file di definizione del report. Quando si incorpora un'immagine, Progettazione report esegue la codifica MIME dell'immagine e la archivia in formato testo nella definizione del report.

Come aggiungere un'immagine incorporata a un report

1. Aprire il file di definizione del report del client (con estensione rdlc) in modalità progettazione grafica.

2. Scegliere Immagini incorporate dal menu Report e aggiungere tutte le immagini che si desidera utilizzare nel report. Se il menu Report non è disponibile, fare clic nell'area di progettazione del report.

3. Trascinare nel layout del report il controllo immagine dalla casella degli strumenti. Scegliere il controllo immagine utilizzato per report di ReportViewer.

4. Selezionare l'immagine e quindi aprire la finestra Proprietà in Visual Studio.

5. Impostare Source su Embedded.

6. Impostare Value su un'immagine incorporata nella definizione del report. È possibile selezionare l'immagine desiderata da un elenco a discesa.

Utilizzo di un'immagine esterna o di database in un report

Per utilizzare un'immagine di database, è possibile specificare il campo di database che contiene l'immagine purché il tipo MIME sia JPG, PNG o BMP. Se l'immagine viene archiviata come oggetto binario, è necessario scrivere un'espressione che consenta di convertirla in un tipo supportato.

Per impostazione predefinita, l'utilizzo di immagini esterne in un report di ReportViewer non è attivata. Per utilizzare un'immagine esterna, è necessario impostare la proprietà EnableExternalImages nel codice. A seconda della configurazione della rete, potrebbe essere anche necessario ignorare le impostazioni del proxy per consentire la visualizzazione dell'immagine esterna. Per ignorare il proxy locale, è possibile aggiungere le impostazioni seguenti al file Web.config. Quando si modifica il file Web.config, accertarsi di specificare il nome del server proxy utilizzato nella rete:

<system.net>

<defaultProxy>

<proxy usesystemdefault = "false"

bypassonlocal = "true"

proxyaddress = "http://<nomeserverproxy>:80/" />

<defaultProxy>

</system.net>

Immagini di sfondo

È possibile utilizzare un'immagine come sfondo nel corpo del report o in un rettangolo, una casella di testo, una matrice o una tabella. Le proprietà disponibili per un'immagine di sfondo sono le stesse valide per le immagini. È inoltre possibile specificare in quale modo ripetere l'immagine per riempire lo sfondo dell'elemento.

Nota

Se si definisce un'immagine di sfondo per il corpo del report, ma non l'intestazione della pagina o il piè di pagina, nei report HTML è automaticamente utilizzata la stessa immagine di sfondo in tutte e tre le aree del report. Per non utilizzare l'immagine di sfondo nell'intestazione o nel piè di pagina, è necessario definire in modo esplicito un'immagine diversa per tali aree. Se non si desidera visualizzare immagini in tali aree, è possibile creare e assegnare una piccola immagine trasparente all'intestazione o al piè di pagina che crei un effetto di assenza di immagini.

Per aggiungere un'immagine di sfondo, eseguire le operazioni seguenti:

1. Aprire il file di definizione del report del client (con estensione rdlc) in modalità progettazione grafica.

2. Selezionare l'elemento del report a cui si desidera aggiungere un'immagine di sfondo.

   Nota
   I soli elementi del report a cui è possibile applicare immagini di sfondo sono i rettangoli, le caselle di testo, le tabelle, le matrici, gli elenchi o il corpo del report.

3. Nella finestra Proprietà espandere la proprietà BackgroundImage e quindi eseguire le operazioni seguenti:

   • Per Source selezionare External, Embedded o Database.

     Nota
     Per utilizzare un'immagine del progetto, selezionare External.

   • Per Value digitare o selezionare un'espressione che restituisca l'origine dell'immagine.

     Se la proprietà Source è impostata su External, l'espressione deve restituire un percorso valido per un'immagine, ovvero un percorso statico relativo a un'immagine disponibile in un server di report oppure un percorso basato su un campo. Se l'immagine è archiviata nel progetto, digitare il nome dell'immagine così come è riportato nel progetto.

     Se la proprietà Source è impostata su Embedded, l'espressione deve restituire il nome di un'immagine incorporata nel report. Se la proprietà Source è impostata su Database, l'espressione deve restituire un campo contenente dati immagine binari.

   • Per MIMEType selezionare il tipo MIME appropriato per l'immagine.

     Nota
     Il valore di MIMEType verrà applicato solo se la proprietà Source è impostata su Database. Se la proprietà Source è impostata su External o Embedded, il valore di MIMEType verrà ignorato.

Per BackgroundRepeat selezionare Repeat, NoRepeat, RepeatX o RepeatY.

Vedere anche

Concetti

Aggiunta di rettangoli, linee e bordi a un report (Progettazione report di Visual Studio)
Creazione di origini dei dati per un report
Aggiunta di aree dati a un report (Progettazione report di Visual Studio)
Aggiunta delle funzionalità di interattività, visibilità e spostamento a un report (Progettazione report di Visual Studio)
Definizione di un layout del report (Progettazione report di Visual Studio)