Usar referencias a la colección de parámetros (Generador de informes y SSRS)
Los parámetros de informe son una de las colecciones integradas a las que se puede hacer referencia desde una expresión. Al incluir parámetros en una expresión, puede personalizar los datos y el aspecto de los informes basándose en las opciones seleccionadas por el usuario. Se pueden usar expresiones para cualquier propiedad de elemento de informe o de cuadro de texto que proporcione la opción (Fx) o <Expresión>. Las expresiones también se usan para controlar el contenido y el aspecto de los informes de otras maneras. Para obtener más información, vea Ejemplos de expresiones (Generador de informes y SSRS).
Cuando se comparan los valores de los parámetros en tiempo de ejecución con los valores de los campos del conjunto de datos, los tipos de datos de los dos elementos que se comparan deben coincidir. Los parámetros de informe pueden ser de uno de los tipos siguientes: Boolean, DateTime, Integer, Float, o Text, que representa el tipo de datos subyacente String. Es posible que tenga que convertir el tipo de datos del valor del parámetro para que coincida con el valor del conjunto de datos. Para obtener más información, vea Tipos de datos en expresiones (Generador de informes y SSRS).
Para incluir una referencia de parámetro en una expresión, debe entender cómo especificar la sintaxis correcta para la referencia de parámetro, que varía dependiendo de si el parámetro es de un solo valor o de varios valores.
[!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.
Usar un parámetro de un solo valor en una expresión
En la tabla siguiente se muestran ejemplos de la sintaxis que se debe usar cuando se incluye una referencia a un parámetro de un solo valor de cualquier tipo de datos en una expresión.
Ejemplo |
Descripción |
|---|---|
=Parameters!<ParameterName>.IsMultiValue |
Devuelve False. Comprueba si un parámetro es de varios valores. Si el valor es True, el parámetro es de varios valores y es una colección de objetos. Si el valor es False, el parámetro es de un solo valor y es un solo objeto. |
=Parameters!<ParameterName>.Count |
Devuelve el valor entero 1. Para un parámetro de un solo valor, el recuento es siempre 1. |
=Parameters!<ParameterName>.Label |
Devuelve la etiqueta del parámetro, se suele utilizar como nombre para mostrar de una lista desplegable de valores disponibles. |
=Parameters!<ParameterName>.Value |
Devuelve el valor del parámetro. Si no se ha establecido la propiedad Label, este valor aparece en la lista desplegable de valores disponibles. |
=CStr(Parameters! <ParameterName>.Value) |
Devuelve el valor del parámetro como una cadena. |
=Fields(Parameters!<ParameterName>.Value).Value |
Devuelve el valor del campo que tiene el mismo nombre que el parámetro. |
Para obtener más información sobre cómo usar parámetros en los filtros, vea Agregar filtros de conjunto de datos, filtros de región de datos y filtros de grupo (Generador de informes y SSRS).
Usar un parámetro de varios valores en una expresión
En la tabla siguiente se muestran ejemplos de la sintaxis que se debe usar cuando se incluye una referencia a un parámetro de varios valores de cualquier tipo de datos en una expresión.
Ejemplo |
Descripción |
|---|---|
=Parameters!<MultivalueParameterName>.IsMultiValue |
Devuelve True o False. Comprueba si un parámetro es de varios valores. Si el valor es True, el parámetro es de varios valores y es una colección de objetos. Si el valor es False, el parámetro es de un solo valor y es un solo objeto. |
=Parameters!<MultivalueParameterName>.Count |
Devuelve un valor entero. Se refiere al número de valores. Para un parámetro de un solo valor, el recuento es siempre 1. Para un parámetro de varios valores, el recuento es 0 o más. |
=Parameters!<MultivalueParameterName>.Value(0) |
Devuelve el primer valor de un parámetro de varios valores. |
=Parameters!<MultivalueParameterName>.Value(Parameters!<MultivalueParameterName>.Count-1) |
Devuelve el último valor de un parámetro de varios valores. |
=Split("Value1,Value2,Value3",",") |
Devuelve una matriz de valores. Cree una matriz de valores para un parámetro de varios valores de tipo String. Puede utilizar cualquier delimitador del segundo parámetro para Split. Esta expresión puede utilizarse para establecer valores predeterminados para un parámetro de varios valores o para crear un parámetro de varios valores que se enviará a un subinforme o a un informe detallado. |
=Join(Parameters!<MultivalueParameterName>.Value,", ") |
Devuelve un valor de tipo String formado por una lista de valores seleccionados por comas en un parámetro de varios valores. Puede utilizar cualquier delimitador del segundo parámetro para Join. |
=”Report for: “ & JOIN(Parameters!<MultivalueParameterName>.Value," & “ ) |
Devuelve un String formado por una lista de valores seleccionados en un parámetro de varios valores, precedido por una cadena de texto que introduce la lista de valores. |
Para obtener más información sobre cómo usar parámetros en los filtros, vea Parámetros de informe (Generador de informes y SSRS).
Vea también
Tasks
Agregar, cambiar o eliminar parámetros de informe (Generador de informes y SSRS)
Tutorial: Agregar un parámetro a un informe (Generador de informes)
Referencia
Colecciones integradas en expresiones (Generador de informes y SSRS)
Conceptos
Expresiones (Generador de informes y SSRS)
Filtros de uso frecuente (Generador de informes y SSRS)