Compartir a través de


Función RunningValue (Generador de informes y SSRS)

Devuelve un agregado actualizado de todos los valores numéricos no NULL especificados por la expresión, que se evalúa en el contexto del ámbito especificado.

[!NOTA]

Puede crear y modificar las definiciones de informe (.rdl) en el Generador de informes y en el Diseñador de informes en SQL Server Data Tools. Cada entorno de creación proporciona varias maneras de crear, abrir y guardar informes y elementos relacionados. Para obtener más información, vea la información sobre el diseño de informes en el Generador de informes y el Administrador de informes (SSRS) en el sitio web microsoft.com.

Sintaxis

RunningValue(expression, function, scope)

Parámetros

  • expression
    Expresión en la que se lleva a cabo la agregación, por ejemplo, [Quantity].

  • function
    (Enum). Nombre de la función de agregado que se aplica a la expresión; por ejemplo, Sum. Esta función no puede ser RunningValue, RowNumber ni Aggregate.

  • scope
    (String) Constante de cadena que es el nombre de un conjunto de datos, grupo, región de datos o NULL (Nothing en Visual Basic), que especifica el contexto en el que evaluar la agregación. Nothing especifica el contexto más externo, normalmente el conjunto de datos de informe.

Tipo devuelto

Viene determinado por la función de agregado especificada en el parámetro function.

Comentarios

El valor para RunningValue se restablece en 0 para cada nueva instancia del ámbito. Si se especifica un grupo, el valor actual se restablece cuando cambia la expresión de grupo. Si se especifica una región de datos, el valor actual se restablece en cada instancia nueva de la región de datos. Si se especifica un conjunto de datos, el valor actual no se restablece en todo el conjunto de datos.

RunningValue no se puede utilizar en un filtro o expresión de ordenación.

El conjunto de datos para los que se calcula el valor en ejecución debe tener el mismo tipo de datos. Si desea convertir datos de varios tipos de datos numéricos al mismo tipo de datos, use funciones de conversión como CInt, CDbl o CDec. Para obtener más información, vea Funciones de conversión de tipos.

Scope no puede ser una expresión.

Expression puede contener llamadas a las funciones de agregados anidados con las siguientes excepciones y condiciones:

  • El ámbito para los agregados anidados debe ser igual que el ámbito del agregado exterior, o ser contenido por él. Para todos los ámbitos distintos de la expresión, un ámbito debe estar en una relación secundaria con respecto a todos los otros ámbitos.

  • El ámbito para los agregados anidados no puede ser el nombre de un conjunto de datos.

  • Expression no debe contener las funciones First, Last, Previous o RunningValue.

  • Expression no debe contener a los agregados anidados que especifican recursive.

Para calcular el valor actual del número de filas, use RowNumber. Para obtener más información, vea Función RowNumber (Generador de informes y SSRS).

Para obtener más información, vea Referencia a las funciones de agregado (Generador de informes y SSRS) y Ámbito de expresión para los totales, agregados y colecciones integradas (Generador de informes y SSRS).

Para obtener más información acerca de los agregados recursivos, vea Crear grupos de jerarquía recursiva (Generador de informes y SSRS).

Descripción

El ejemplo de código siguiente proporciona la suma actual del campo denominado Cost en el ámbito más externo, que es el conjunto de datos.

Código

=RunningValue(Fields!Cost.Value, Sum, Nothing)

Vea también

Referencia

Ejemplos de expresiones (Generador de informes y SSRS)

Conceptos

Usar expresiones en informes (Generador de informes y SSRS)

Tipos de datos en expresiones (Generador de informes y SSRS)

Ámbito de expresión para los totales, agregados y colecciones integradas (Generador de informes y SSRS)