Função First (Construtor de Relatórios 2.0)
Retorna o primeiro valor no escopo fornecido da expressão especificada.
Sintaxe
First(expression, scope)
Parâmetros
expression
(Variant ou Binary) A expressão na qual executar a agregação, por exemplo, =Fields!FieldName.Value. A expressão não pode conter funções de agregação.scope
(String) Opcional. O nome de um conjunto de dados, grupo ou região de dados que contém os itens de relatório aos quais a função de agregação deve ser aplicada. Se o parâmetro scope não estiver especificado, será usado o escopo atual. Para obter mais informações, consulte Usando funções internas de relatório e de agregação em expressões (Construtor de Relatórios 2.0) e Calculando totais e outros agregados (Construtor de Relatórios 2.0).
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 para uma página para produzir cabeçalhos em estilo de dicionário que exibem as primeiras e as últimas entradas em uma página.
O valor de scope não pode ser uma expressão e deve fazer referência ao escopo atual ou a um escopo contentor.
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")