Função First (Construtor de Relatórios e SSRS)
Retorna o primeiro valor no escopo fornecido da expressão especificada.
Observação
Você pode criar e modificar definições de relatório (.rdl) no Construtor de Relatórios e no Designer de Relatórios no SQL Server Data Tools. Cada ambiente de criação fornece modos diferentes para criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Criando relatórios em Report Designer e Report Builder (SSRS) na Web em microsoft.com.
Sintaxe
First(expression, scope)
parâmetros
expressão
(Variant
ou Binary
) A expressão na qual executar a agregação, por exemplo, =Fields!FieldName.Value
.
escopo
(String
) Opcional. O nome de um conjunto de dados, um grupo ou uma região de dados que contém os itens de relatório aos quais a função de agregação deve ser aplicada. Se scope não estiver especificado, será usado o escopo atual.
Tipo de retorno
Determinado pelo tipo de expressão.
Comentários
A função First
retorna o primeiro valor em um conjunto de dados depois que toda a classificação e filtragem tiverem sido aplicadas no escopo especificado.
A função First
não pode ser usada em expressões de filtro de grupo com qualquer coisa, exceto o escopo atual (padrão).
Também é possível usar a função First
em um cabeçalho de página para retornar o primeiro valor da coleção ReportItems
de uma página para produzir cabeçalhos em estilo de dicionário que exibem a primeira e a última entradas em uma página.
O valor de scope deve ser uma constante de cadeia de caracteres e não pode ser uma expressão. Para agregações externas ou que não especificam outras agregações, scope deve se referir ao escopo atual ou a um escopo contentor. Para agregações de agregações, as agregações aninhadas podem especificar um escopo filho.
Expression pode conter chamadas para funções de agregação aninhadas com as seguintes exceções e condições:
Scope para agregações aninhadas deve ser igual ao escopo da agregação externa ou deve estar contido nela. Para todos os escopos distintos na expressão, um escopo deve estar em uma relação filho com todos os outros escopos.
Scope para agregações aninhadas não pode ser o nome de um conjunto de dados.
A expressão não deve conter
First
funções ,Last
,Previous
ouRunningValue
.Expression não deve conter agregações aninhadas que especifiquem recursive.
Para obter mais informações, confira Referência de funções de agregação (Construtor de Relatórios e SSRS) e Escopo das expressões para totais, agregações e coleções internas (Construtor de Relatórios e SSRS).
Para obter mais informações sobre agregações recursivas, confira Criando grupos de hierarquias recursivas (Construtor de Relatórios e SSRS).
Exemplo
O exemplo de código a seguir retorna o número do primeiro produto no grupo Category
de uma região de dados:
=First(Fields!ProductNumber.Value, "Category")
Consulte Também
Uso de expressões em relatórios (Construtor de Relatórios e SSRS)
Exemplos de expressões (Construtor de Relatórios e SSRS)
Tipos de dados em expressões (Construtor de Relatórios e SSRS)
Escopo das expressões para totais, agregações e coleções internas (Construtor de Relatórios e SSRS)