Função RunningValue (Construtor de Relatórios e SSRS)
Retorna uma agregação contínua de todos os valores numéricos não nulos especificados pela expressão, avaliados para o escopo fornecido.
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
RunningValue(expression, function, scope)
parâmetros
expressão
A expressão na qual executar a agregação, por exemplo, [Quantity].
função
(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.
escopo
(String) Uma constante de cadeia de caracteres que é 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.
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.
RunningValue não pode ser usado em um filtro ou expressão de classificação.
O conjunto de dados para o qual o valor em execução é calculado 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.
OScope não pode ser uma expressão.
Expression pode conter chamadas para funções de agregação aninhadas com as seguintes exceções e condições:
O escopo 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.
O escopo para agregações aninhadas não pode ser o nome de um conjunto de dados.
A expressão não deve conter
Firstfunções ,Last,PreviousouRunningValue.Expression não deve conter agregações aninhadas que especifiquem recursive.
Para calcular o valor em uso do número de linhas, use RowNumber. Para obter mais informações, confira Função RowNumber (Construtor de Relatórios e SSRS).
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 Criação de Grupos de Hierarquias Recursivas (Construtor de Relatórios e SSRS).
Exemplos
O exemplo de código a seguir fornece uma soma parcial do campo denominado Cost no escopo mais externo que é o conjunto de dados.
=RunningValue(Fields!Cost.Value, Sum, Nothing)
O exemplo de código a seguir fornece uma soma parcial do campo denominado Score no conjunto de dados denominado DataSet1.
=RunningValue(Fields!Score.Value,sum,"DataSet1")
O exemplo de código a seguir fornece uma soma parcial do campo denominado Traffic Charges no escopo mais externo.
=RunningValue(Fields!Traffic Charges.Value, Sum, Nothing)
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)