Accesso agli assembly personalizzati tramite espressioni

Dopo aver creato un assembly personalizzato, renderlo disponibile per Progettazione report o il server di report, aggiungere i criteri di sicurezza appropriati e aggiungere un riferimento all'assembly personalizzato nella definizione del report, è possibile accedere ai membri delle classi nell'assembly usando espressioni di report. Per fare riferimento al codice personalizzato in un'espressione, è necessario chiamare il membro di una classe nell'assembly. La modalità di esecuzione di tale operazione dipende dal tipo di metodo, ovvero statico o basato su istanze.

Chiamare membri statici da un file di definizione del report

I membri statici appartengono alla classe o al tipo e non a un oggetto per il quale è stata creata un'istanza. È possibile accedere a questi membri chiamandoli direttamente dalla classe. È consigliabile utilizzare i membri statici per chiamare le funzioni personalizzate in un report ogni qualvolta è possibile, perché i membri statici offrono prestazioni migliori. Per chiamare un membro statico, è necessario farvi riferimento come espressione nel formato =SpazioDeiNomi.Classe.Metodo.

Chiamare membri statici

• Per chiamare un membro statico, impostare l'espressione in modo che corrisponda al nome completo del membro che include lo spazio dei nomi, il nome della classe e il nome del membro. Nell'esempio seguente viene chiamato il metodo ToGBP, che consente di convertire il valore del campo StandardCost da dollari a sterline e di visualizzarlo in un report:

  =CurrencyConversion.DollarCurrencyConversion.ToGBP(Fields!StandardCost.Value)  
  

Informazioni importanti relative a campi e proprietà statici

Attualmente, tutti i report vengono eseguiti nello stesso dominio dell'applicazione. Questo significa che i report con dati statici specifici dell'utente espongono questi dati alle altre istanze dello stesso report. In questo modo, i dati statici di un utente possono essere resi disponibili per tutti gli utenti che attualmente eseguono un report specifico. Per questo motivo, è consigliabile non usare campi statici o proprietà negli assembly personalizzati o nell'elemento Code. Usare invece campi o proprietà dell'istanza nei report. È comunque possibile usare metodi statici, perché non archiviano lo stato o i dati.

Chiamare i membri dell'istanza da un file di definizione del report

Se l'assembly personalizzato contiene membri di istanza a cui è necessario accedere in una definizione del report, è necessario aggiungere al report un nome di istanza per la classe. È possibile aggiungere un nome di istanza per una classe usando la scheda Codice della finestra di dialogo Proprietà report. Per altre informazioni sull'aggiunta di istanze di classi a un report, vedere Riferimenti a codice personalizzato e ad assembly in espressioni in Progettazione report (SSRS).

Per chiamare un membro statico, è necessario farvi riferimento come espressione nel formato =Code*.NomeIstanza.Metodo*.

Chiamare i membri dell'istanza

• Per chiamare un membro di istanza di un assembly personalizzato, è necessario fare riferimento alla parola chiave Code seguita dal nome dell'istanza e dal metodo. Nell'esempio seguente viene chiamato il metodo di istanza ToEUR, che consente di convertire il valore del campo StandardCost da dollari a euro e di visualizzarlo in un report:

  =Code.m_myDollarCoversion.ToEUR(Fields!StandardCost.Value)  
  

Contenuto correlato

Uso di assembly personalizzati con i report