Expresión (cuadro de diálogo)

  • Artículo

Use el cuadro de diálogo Expresión para escribir expresiones de Microsoft Visual Basic para las propiedades de los elementos de informe. Puede usar expresiones para establecer muchas propiedades, como el color, la fuente y los bordes. En tiempo de ejecución, el procesador de informes evalúa las expresiones y usa el resultado como valor de la propiedad.

Una expresión puede ser sencilla o compleja. Puede escribir directamente las expresiones simples en un cuadro de texto en la superficie de diseño o en un cuadro de diálogo. Para crear expresiones complejas, use el cuadro de diálogo Expresión. Puede crear una expresión cada vez. Para obtener más información, vea Expresiones (Generador de informes y SSRS).

Para abrir el cuadro de diálogo Expresión, haga clic en el botón Expresión (fx) de los cuadros de diálogo o seleccione Expresión en el menú contextual o en las listas desplegables del panel de propiedades. Para obtener más información, vea Usar expresiones en informes (Generador de informes y SSRS).

El cuadro de diálogo Expresión incluye una ventana de código, un árbol de categorías, elementos de categoría, un panel de descripción y un panel de ejemplo.

El cuadro de diálogo Expresión depende del contexto; los elementos y descripciones de categorías cambian de acuerdo con la categoría de expresiones con que se está trabajando. Admite IntelliSense, la finalización de instrucciones, ejemplos de llamadas a funciones y colores de sintaxis que ayudan a detectar errores de sintaxis.

Construcciones de expresiones

Las expresiones comienzan por un signo igual (=) y pueden incluir constantes, literales, operadores y referencias a campos integrados, colecciones integradas, funciones integradas, funciones de la biblioteca en tiempo de ejecución de Visual Basic, clases de Common Language Runtime de .NET Framework y funciones personalizadas. En la lista siguiente se describen las categorías y los valores que puede agregar a una expresión.

  • Establecer expresión para: <PropertyName>
    Nombre de la propiedad cuya expresión está definiendo. También puede establecer esta propiedad, por nombre, en el panel de propiedades.

  • Constantes
    Proporciona una lista de valores predefinidos válidos para esta propiedad (para las propiedades que están basadas en constantes). Por ejemplo, una propiedad basada en colores muestra los nombres de los colores válidos. Para una propiedad que es un tipo de datos Boolean, los valores son True y False.

    No todos los elementos que admiten expresiones pueden establecerse en una constante. Si una propiedad no se puede establecer en un valor constante, el panel de descripciones proporciona esta información.

  • Campos integrados
    Proporciona una lista de los elementos de la colección global que puede utilizar en una expresión. Algunas colecciones solo se admiten una vez publicado el informe en el servidor. Para obtener más información, vea Referencias a campos globales y de usuario integrados (Generador de informes y SSRS).

  • Parámetros
    Proporciona una lista de parámetros de informe.

  • Campos ( <selected Dataset> )
    Muestra la lista de campos para el conjunto de datos seleccionado en la categoría Conjuntos de datos. Haga doble clic en un campo para copiarlo en el cuadro Expresión.

  • Conjuntos de datos
    Proporciona una lista de conjuntos de datos disponibles y muestra los campos miembros del conjunto de datos.

  • Variables
    Muestra una lista de variables de informe. Para obtener más información, vea Referencias a las colecciones de variables de informe y de grupo (Generador de informes y SSRS).

  • Operadores
    Muestra los operadores que puede incluir en un cálculo o manipulación de cadena. Para obtener más información, vea Usar operadores en expresiones (Generador de informes y SSRS).

  • Funciones comunes
    Muestra funciones comunes, agrupadas por tipos. Al seleccionar una función en el panel Elemento, aparecen una descripción y un ejemplo.

    Entre las funciones comunes se incluyen funciones integradas de informe y de agregado, funciones de la biblioteca en tiempo de ejecución de Visual Basic y clases de Common Language Runtime (CLR) de .NET Framework en los espacios de nombres Math y Convert. También puede agregar referencias a clases de CLR y ensamblados externos que no aparecen en la lista de categorías. Para obtener más información, vea Referencias a ensamblados y código personalizado en expresiones en el Diseñador de informes (SSRS).

Opciones

  • Ventana de código
    Utilice la ventana de código del panel superior para escribir una expresión. Cuando se abre el cuadro de diálogo Expresión, la ventana de código contiene la expresión. Puede reemplazar o revisar la expresión. Puede agregar llamadas a funciones, operadores, constantes, campos, parámetros, elementos de las colecciones globales y referencias a código personalizado. La ventana de código muestra los cambios a medida que se realizan.

    Los subrayados ondulados en rojo indican un error de sintaxis. Mantenga el mouse sobre el texto subrayado para ver el mensaje de error.

    Si escribe elementos de las colecciones globales seguidos por un separador de puntuación, verá una lista desplegable de los miembros o las propiedades disponibles. En la lista desplegable, puede escribir los primeros caracteres seguidos de un tabulador para rellenar la selección automáticamente.

    Al escribir un nombre de función seguido por un paréntesis izquierdo, verá una información sobre herramientas que proporciona información sobre los parámetros y valores devueltos por la función.

  • Categoría
    Muestra categorías de expresiones. Si se elige una categoría, se establece un contexto para crear una expresión y se cambia la lista de valores válidos en el panel Elemento. Por ejemplo, si está creando una expresión para un valor de cuadro de texto, expanda Funciones comunes y seleccione Funciones de agregado para mostrar Avg, Count y otras funciones en el panel Elemento.

  • Elemento
    Muestra la lista de valores válidos para la categoría seleccionada. Haga doble clic en un elemento para agregar el texto de la expresión para este elemento en el punto de inserción en la ventana de código.

  • Valores
    En función de la categoría y el elemento que seleccione, el tercer panel contiene una descripción, una expresión de ejemplo o una lista de valores válidos. Arrastre el borde del cuadro de diálogo para ampliar el área de ejemplo.

Vea también

Tasks

Agregar una expresión (Generador de informes y SSRS)

Referencia

Ejemplos de expresiones (Generador de informes y SSRS)

Colecciones integradas en expresiones (Generador de informes y SSRS)

Conceptos

Expresiones (Generador de informes y SSRS)

Usar expresiones en informes (Generador de informes y SSRS)

Aplicar formato a números y fechas (Generador de informes y SSRS)

Usar referencias a la colección de parámetros (Generador de informes y SSRS)

Ejemplos de expresión de grupo (Generador de informes y SSRS)

Ejemplos de ecuaciones de filtro (Generador de informes y SSRS)

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