Funciones integradas para informes (Diseñador de informes de Visual Studio)

ReportViewer proporciona funciones integradas que puede utilizar en expresiones de informe. Las funciones integradas se pueden utilizar en expresiones que se incluyen en archivos de definición de informes de cliente (.rdlc) y que se procesan en un servidor de informes de SQL Server 2005 Reporting Services. La compatibilidad con las funciones la proporcionan los controles ReportViewer y Reporting Services.

Las funciones integradas se organizan en dos categorías: funciones de agregado y funciones varias. Los ejemplos de agregado de datos incluyen el cálculo de una suma de todos los valores de un campo determinado mediante la función Sum. Las funciones de agregado se pueden usar en expresiones de cualquier elemento de informe.

Además de las funciones integradas, las expresiones que incluye en informes pueden utilizar cualquier función de Visual Basic. Para obtener más información acerca de las funciones de Visual Basic, vea Funciones (Visual Basic).

Funciones varias

La tabla siguiente describe funciones de propósito general que puede utilizar.

Función Descripción

Función InScope (Diseñador de informes de Visual Studio)

Indica si la instancia actual de un elemento se halla en el ámbito especificado.

Función Level (Diseñador de informes de Visual Studio)

Devuelve el nivel actual de profundidad de una jerarquía recursiva.

Función Previous (Diseñador de informes de Visual Studio)

Devuelve la instancia anterior del ámbito especificado.

Funciones de agregado estándar

La tabla siguiente describe funciones de agregado estándar que puede utilizar.

Función Descripción

Avg

Devuelve el promedio de todos los valores no NULL de la expresión especificada.

Count

Devuelve el recuento de los valores de la expresión especificada.

CountDistinct

Devuelve el recuento de todos los valores Distinct de la expresión especificada.

CountRows

Devuelve el recuento de filas del ámbito especificado.

First

Devuelve el primer valor de la expresión especificada.

Last

Devuelve el último valor de la expresión especificada.

Max

Devuelve el valor máximo de todos los valores no NULL de la expresión especificada.

Min

Devuelve el valor mínimo de todos los valores no NULL de la expresión especificada.

StDev

Devuelve la desviación estándar de todos los valores no NULL de la expresión especificada.

StDevP

Devuelve la desviación estándar de rellenado de todos los valores no NULL de la expresión especificada.

Sum

Devuelve la suma de los valores de la expresión especificada.

Var

Devuelve la varianza de todos los valores no NULL de la expresión especificada.

VarP

Devuelve la varianza de rellenado de todos los valores no NULL de la expresión especificada.

Funciones de agregado actualizado

La tabla siguiente describe funciones de agregado actualizado que puede utilizar.

Función Descripción

RowNumber

Devuelve un recuento acumulado de todas las filas del ámbito especificado.

RunningValue

Utiliza una función específica para devolver el agregado actualizado de la expresión indicada.

Funciones de agregado personalizado

La tabla siguiente describe la función de agregado personalizado.

Función Descripción

Aggregate

Devuelve un agregado personalizado de la expresión especificada, tal como lo haya definido el proveedor de datos.

Ámbito

Todas las funciones de agregado utilizan el parámetro Scope, que define el ámbito en el que se ejecutará la función de agregado. Se consideran ámbitos válidos los nombres de agrupación, conjunto de datos o región de datos. En cuanto a las agrupaciones o regiones de datos, sólo pueden usarse como ámbito las que contienen directa o indirectamente la expresión. En el caso de expresiones incluidas en regiones de datos, el parámetro Scope es opcional para todas las funciones de agregado. Si se omite el parámetro Scope, el ámbito del agregado será la región de datos o agrupación más interna a la que pertenezca el elemento del informe. Si especifica Nothing como ámbito, se establece el ámbito como la región de datos externa a la que pertenece el elemento del informe.

En expresiones externas a las regiones de datos, Scope hace referencia a una tabla de datos u objeto Business. En aquellos casos en los que los informes contienen más de un conjunto de datos, es imprescindible especificar el parámetro Scope. Si un informe contiene sólo un conjunto de datos y se omite el parámetro Scope, se establece dicho conjunto de datos como ámbito. No se puede especificar la palabra clave Nothing para elementos de informe externos a una región de datos.

No se puede utilizar el parámetro Scope en encabezados ni pies de página.

Vea también

Conceptos

Crear orígenes de datos para un informe
Usar expresiones en un informe (Diseñador de informes de Visual Studio)
Controles ReportViewer (Visual Studio)
Información general de informes (Visual Studio)