Função RunningValue (Construtor de Relatórios 2.0)
Retorna uma agregação contínua de todos os valores numéricos não nulos especificados pela expressão, avaliados para o escopo fornecido.
Sintaxe
RunningValue(expression, function, scope)
Parâmetros
expression
A expressão na qual executar a agregação, por exemplo, [Quantity]. Essa expressão não pode conter funções de agregação.function
(Enum) O nome da função de agregação a ser aplicado à expressão, por exemplo, Sum. Essa função não pode ser RunningValue, RowNumber ou Aggregate.scope
(String) O nome de um conjunto de dados, região de dados ou grupo ou nulo (Nothing no Visual Basic), que especifica o contexto no qual avaliar a agregação. Nothing especifica o contexto mais externo, geralmente o conjunto de dados do relatório. 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 pela função de agregação especificada no parâmetro function.
Comentários
O valor de RunningValue é redefinido como 0 para cada nova instância do escopo. Se um grupo for especificado, o valor em uso será redefinido quando a expressão de grupo for alterada. Se uma região de dados for especificada, o valor em uso será redefinido para cada nova instância da região de dados. Se um conjunto de dados for especificado, o valor em uso não será redefinido em todo o conjunto de dados.
As restrições para RunningValue também são determinadas pela função de agregação especificada no parâmetro function. O RunningValue não pode ser usado em uma expressão de classificação ou de filtro.
O conjunto de dados especificado na expressão deve ter o mesmo tipo de dados. Para converter dados que têm vários tipos de dados numéricos no mesmo tipo de dados, use funções de conversão, como CInt, CDbl ou CDec. Para obter mais informações, consulte Funções de conversão de tipo.
O Scope não pode ser uma expressão.
Para calcular o valor em uso do número de linhas, use RowNumber. Para obter mais informações, consulte Função RowNumber (Construtor de Relatórios 2.0).
Descrição
O exemplo de código a seguir fornece uma soma parcial do campo denominado Cost no escopo mais externo que é o conjunto de dados.
Código
=RunningValue(Fields!Cost.Value, Sum, Nothing)