Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Une fois que vous avez créé un assembly personnalisé, mis à la disposition du Concepteur de rapports ou du serveur de rapports, ajouté la stratégie de sécurité appropriée et ajouté une référence à votre assembly personnalisé dans votre définition de rapport, vous pouvez accéder aux membres des classes de votre assembly à l’aide d’expressions de rapport. Pour faire référence à du code personnalisé dans une expression, vous devez appeler le membre d'une classe au sein de l'assembly. La procédure pour ce faire dépend du type de méthode, à savoir statique ou basée sur une instance.
Appel de membres statiques à partir d’un fichier de définition de rapport
Les membres statiques appartiennent à la classe ou au type lui-même et non à un objet instancié. Ces membres sont accessibles en les appelant directement à partir de la classe. Vous devez utiliser des membres statiques pour appeler des fonctions personnalisées dans un rapport dans la mesure du possible, car les membres statiques fonctionnent le mieux. Pour appeler un membre statique, vous devez le référencer en tant qu’expression qui prend la forme =Namespace.Class.Method.
Pour appeler des membres statiques
Pour appeler un membre statique, définissez votre expression sur le nom complet du membre, qui inclut l’espace de noms, le nom de classe et le nom du membre. L’exemple suivant appelle la méthode ToGBP , qui convertit la valeur de champ StandardCost de dollars en livres sterling et l’affiche dans un rapport :
=CurrencyConversion.DollarCurrencyConversion.ToGBP(Fields!StandardCost.Value)
Informations importantes sur les champs statiques et les propriétés
Actuellement, tous les rapports sont exécutés dans le même domaine d’application. Cela signifie que les rapports avec des données statiques spécifiques à l’utilisateur exposent ces données à d’autres instances du même rapport. Cette condition peut rendre possible la disponibilité des données statiques d’un utilisateur pour tous les utilisateurs exécutant actuellement un rapport particulier. Pour cette raison, il est vivement recommandé de ne pas utiliser de champs statiques ou de propriétés dans des assemblys personnalisés ou dans l’élément Code ; Utilisez plutôt des champs d’instance ou des propriétés dans vos rapports. Les méthodes statiques peuvent toujours être utilisées, car elles ne stockent pas l’état ou les données.
Appel de membres d’instance à partir d’un fichier de définition de rapport
Si votre assembly personnalisé contient des membres d’instance auxquels vous devez accéder dans une définition de rapport, vous devez ajouter un nom d’instance pour votre classe au rapport. Vous pouvez ajouter un nom d’instance pour une classe à l’aide de l’onglet Code de la boîte de dialogue Propriétés du rapport . Pour plus d’informations sur l’ajout d’instances de classes à un rapport, consultez Custom Code and Assembly References in Expressions in Report Designer (SSRS).
Pour appeler un membre statique, vous devez le référencer en tant qu’expression qui prend la forme = Code*. InstanceName.Method*.
Pour appeler des membres d’instance
Pour appeler un membre d’instance d’un assembly personnalisé, vous devez référencer le mot clé Code suivi du nom de l’instance et de la méthode. L’exemple suivant appelle une méthode d’instance ToEUR qui convertit la valeur du champ StandardCost de dollars en euros et l’affiche dans un rapport :
=Code.m_myDollarCoversion.ToEUR(Fields!StandardCost.Value)