Partilhar via


Funções do Construtor de Relatórios - Função de contagem num relatório paginado (Construtor de Relatórios)

Aplica-se a: Construtor de Relatórios da Microsoft (SSRS) Designer de Relatórios do Power BI no SQL Server Data Tools

Devolve uma contagem de valores não nulos especificados pela expressão num relatório paginado, avaliado no contexto do âmbito dado.

Observação

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, no Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Sintaxe

  
Count(expression, scope, recursive)  

Parâmetros

expressão
(Variante ou Binário) A expressão sobre a qual realizar a agregação, por exemplo, =Fields!FieldName.Value.

âmbito
(Fio) O nome de um conjunto de dados, grupo ou região de dados que contém os itens do relatório aos quais aplicar a função agregada. Se o âmbito não for especificado, o âmbito atual é utilizado.

recursive
(Tipo Enumerado) Opcional. Simples (padrão) ou RdlRecursive. Especifica se deve realizar a agregação recursivamente.

Tipo de Retorno

Devolve um inteiro.

Observações

O valor do âmbito deve ser uma constante de cadeia e não pode ser uma expressão. Para agregados externos ou agregados que não especificam outros agregados, o âmbito deve referir-se ao âmbito atual ou a um âmbito contido. Para agregados de agregados, agregados aninhados podem especificar um âmbito filho.

A expressão pode conter chamadas para funções agregadas aninhadas com as seguintes exceções e condições:

  • O âmbito para agregados aninhados deve ser igual ou estar contido pelo âmbito do agregado exterior. Para todos os escopos distintos na expressão, um escopo deve ter uma relação hierárquica com todos os outros escopos.

  • O âmbito para agregados aninhados não pode ser o nome de um conjunto de dados.

  • A Expressão não deve conter as funções Primeiro, Último, Anterior ou Valor Executante .

  • A expressão não deve conter agregados aninhados que especifiquem recursivo.

Para mais informações, consulte Aggregate Functions Reference (Report Builder e SSRS) e Expression Scope for Totais, Aggregates e Coleções Incorporadas (Report Builder e SSRS).

Para mais informações sobre agregados recursivos, consulte Criação de Grupos de Hierarquia Recursiva (Construtor de Relatórios e SSRS).

Example

Description

O exemplo de código seguinte mostra uma expressão que calcula o número de valores não nulos de Size para o âmbito padrão e para um âmbito de grupo pai. A expressão é adicionada a uma célula numa linha que pertence ao grupo filho GroupbySubcategory. O grupo pai é GroupbyCategory. A expressão apresenta os resultados para GroupbySubcategory (o âmbito padrão) e depois para GroupbyCategory (o âmbito do grupo pai).

Observação

As expressões não devem conter retornos reais de carro nem quebras de linha; estes estão incluídos no exemplo para suportar os renderizadores de documentação. Se copiares o exemplo seguinte, remove os retornos de carro de cada linha.

Código

="Count (Subcategory): " & Count(Fields!Size.Value) &   
"Count (Category): " & Count(Fields!Size.Value,"GroupbyCategory")