Usar expresiones en un informe (Diseñador de informes de Visual Studio)

Puede incluir expresiones de Microsoft Visual Basic en informes de ReportViewer. Utilice estas expresiones para calcular el valor de un elemento de informe, los valores de las propiedades de estilo y formato, u otras propiedades de elementos de informe. Puede utilizar todas las funciones de Visual Basic así como funciones integradas que sólo se admiten en archivos de definición de informe.

Para obtener más información acerca de expresiones habitualmente utilizadas en informes de ReportViewer, vea Expresiones comunes para los informes (Diseñador de informes de Visual Studio).

Expresiones de campo

El tipo más básico de expresión es el que muestra un valor de campo en un cuadro de texto. Se denomina expresión de campo. Para vincular un campo de datos a un elemento del informe, la expresión debe incluir la colección Fields, el nombre del campo y la propiedad Value. El valor se crea automáticamente cuando arrastra el campo hasta el informe. El ejemplo siguiente presenta una expresión que muestra un nombre de producto en un cuadro de texto:

=Fields!Product.Value

Una expresión puede ser breve y hacer referencia a un objeto de campo, o bien, extensa y que admita funciones de decisión o formato basadas en campos u otros elementos de informe. Las expresiones de los elementos y propiedades de informe deben empezar por un signo igual (=). Si no inicia el texto con este carácter, el texto se evaluará como el valor real del campo.

A continuación se incluyen algunos ejemplos de expresiones de campo:

  • Esta expresión concatena los campos FirstName y LastName.

    =Fields!FirstName.Value & " " & Fields!LastName.Value
    
  • Esta expresión realiza una agregación de suma en el campo LineTotal.

    =Sum(Fields!LineTotal.Value)
    

Para obtener más información acerca de la colección Fields, vea Colecciones globales para expresiones en los informes (Diseñador de informes de Visual Studio).

Formato condicional

Las expresiones permiten controlar la apariencia de los elementos de informe. Por ejemplo, se puede escribir una expresión para la propiedad Color de un cuadro de texto para que los datos se muestren con un color distinto según el tipo de datos. A continuación se presenta un ejemplo de formato condicional:

  • Esta expresión, utilizada en la propiedad Color de un cuadro de texto, muestra el valor en rojo si el valor del campo Cost es superior al valor del campo Revenue. Si no se cumple esta condición, el texto aparece en negro.

    =IIf(Fields!Cost.Value > Fields!Revenue.Value, "Red", "Black")
    

Para obtener más información acerca de formato condicional, vea Agregar estilo y formato a un informe (Diseñador de informes de Visual Studio).

Funciones de Reporting Services

Reporting Services ofrece numerosas funciones integradas que pueden utilizarse en las expresiones. Entre éstas se incluyen funciones estándar de agregado, como Sum, Min, Max y Count, además de las funciones como RowNumber y RunningValue. Para obtener una lista completa de las funciones y su descripción, vea Funciones integradas para informes (Diseñador de informes de Visual Studio).

Referencias a clases y código personalizado

Las expresiones de un informe también pueden contener referencias a clases en los espacios de nombre Microsoft.VisualBasic, System.Convert y System.Math. Si se utilizan clases o funciones de espacios de nombre de otros sistemas, es preciso utilizar el espacio de nombres completo; por ejemplo System.Collections.ArrayList.

En caso de necesitar funcionalidad adicional que no ofrezcan las funciones de Reporting Servicies o las clases predeterminadas, puede utilizar un código personalizado, otro ensamblado estándar o un bloque de código de informe. Para ello, debe generar un ensamblado personalizado y crear una referencia al mismo desde una expresión. Para obtener más información, vea Agregar código personalizado a un informe (Diseñador de informes de Visual Studio).

Vea también

Conceptos

Controles ReportViewer (Visual Studio)
Información general de informes (Visual Studio)

Otros recursos

Ejemplos y visitas guiadas