Acessando conjuntos personalizados por meio de expressões

Depois de criar um assembly personalizado, disponibilizá-lo ao Designer de Relatórios ou ao servidor de relatório, adicionar a política de segurança apropriada e adicionar uma referência ao assembly personalizado na definição do relatório, você poderá acessar os membros das classes em seu assembly usando expressões de relatório. Para consultar o código personalizado em uma expressão, você deve chamar o membro de uma classe dentro do assembly. A maneira de fazer isso depende do método ser estático ou baseado em instância.

Chamando membros estáticos de um arquivo de definição de relatório

Membros estáticos pertencem à classe ou tipo em si e não a um objeto instanciado. Esses membros podem ser acessados chamando-os diretamente da classe. Você deve usar membros estáticos para chamar funções personalizadas em um relatório sempre que possível, pois os membros estáticos têm o melhor desempenho. Para chamar um membro estático, você precisa referenciá-lo como uma expressão que usa o formulário =Namespace.Class.Method.

Para chamar membros estáticos

• Para chamar um membro estático, defina sua expressão como o nome totalmente qualificado do membro, que inclui o namespace, o nome da classe e o nome do membro. O exemplo a seguir chama o método ToGBP , que converte o valor do campo StandardCost de dólares em libras esterlinas e o exibe em um relatório:

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

Informações importantes sobre campos estáticos e propriedades

Atualmente, todos os relatórios são executados no mesmo domínio do aplicativo. Isso significa que relatórios com dados estáticos específicos do usuário expõem esses dados a outras instâncias do mesmo relatório. Essa condição pode possibilitar que os dados estáticos de um usuário estejam disponíveis para todos os usuários que executam um relatório específico no momento. Por esse motivo, é altamente recomendável que você não use campos estáticos ou propriedades em assemblies personalizados ou no elemento Code ; em vez disso, use campos de instância ou propriedades em seus relatórios. Métodos estáticos ainda podem ser usados, pois não armazenam dados ou estado.

Chamando membros da instância de um arquivo de definição de relatório

Se o assembly personalizado contiver membros de instância que você precisa acessar em uma definição de relatório, você deverá adicionar um nome de instância para sua classe ao relatório. Você pode adicionar um nome de instância para uma classe usando a guia Código da caixa de diálogo Propriedades do Relatório . Para obter mais informações sobre como adicionar instâncias de classes a um relatório, consulte Referências personalizadas de código e assembly em expressões no Designer de Relatórios (SSRS).

Para chamar um membro estático, você precisa referenciá-lo como uma expressão que usa o formulário = Código*. InstanceName.Method*.

Para chamar membros da instância

• Para chamar um membro de instância de um assembly personalizado, você deve referenciar a palavra-chave Code seguida pelo nome da instância e pelo método. O exemplo a seguir chama um método de instância ToEUR que converte o valor do campo StandardCost de dólares em euros e o exibe em um relatório:

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

Consulte Também

Usar assemblies personalizados com relatórios