Colecciones integradas en expresiones (Generador de informes y SSRS)
En una expresión de un informe, puede incluir referencias a las siguientes colecciones integradas: ReportItems, Parameters, Fields, DataSets, DataSources, Variables y a campos integrados para información global, como el nombre del informe. No todas las colecciones aparecen en el cuadro de diálogo Expresión . Las colecciones DataSets y DataSources solo están disponibles en tiempo de ejecución para los informes publicados en un servidor de informes. ReportItems es un conjunto de cuadros de texto situados en una región del informe; por ejemplo, los cuadros de texto de una página o de un encabezado de página.
Para obtener más información, consulte Expresiones (Generador de informes y SSRS).
Nota:
Puede crear y modificar definiciones de informe (.rdl) en Generador de informes y en 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, consulte Diseño de informes en Diseñador de informes y Generador de informes (SSRS) en la Web en microsoft.com.
Descripción de las colecciones integradas
En la tabla siguiente se enumeran las colecciones integradas disponibles cuando se escribe una expresión. Cada fila incluye: el nombre de programación para la colección con distinción de mayúsculas y minúsculas, si se puede usar el cuadro de diálogo Expresión para agregar una referencia a la colección de forma interactiva, un ejemplo y una descripción que incluye el momento en que se inicializan y se ponen a disposición de los usuarios los valores de la colección.
Colección integrada | Categoría en el cuadro de diálogo Expresión | Ejemplo | Descripción |
---|---|---|---|
Globals |
Campos integrados | =Globals.ReportName - or - =Globals.PageNumber |
Representa variables globales útiles para los informes, como el nombre del informe o el número de página. Siempre está disponible. Para obtener más información, vea Referencias a campos globales y de usuario integrados (Generador de informes y SSRS). |
User |
Campos integrados | =User.UserID O bien =User.Language |
Representa una recopilación de datos acerca del usuario que ejecuta el informe, como la configuración de idioma o el identificador de usuario. Siempre está disponible. Para obtener más información, vea Referencias a campos globales y de usuario integrados (Generador de informes y SSRS). |
Parameters |
Parámetros | =Parameters("ReportMonth").Value O bien =Parameters!ReportYear.Value |
Representa la colección de parámetros de informe (pueden tener uno o varios valores). No está disponible hasta que la inicialización se ha completado. Para más información, consulte Referencias a la colección de parámetros (Generador de informes y SSRS). |
Fields( <Conjunto de datos> ) |
Fields | =Fields!Sales.Value |
Representa la colección de campos del conjunto de datos que están disponibles para el informe. Está disponible una vez que los datos se han recuperado desde un origen de datos en un conjunto de datos. Para obtener más información, vea Referencias a la colección de campos de conjunto de datos (Generador de informes y SSRS). |
DataSets |
No se muestra | =DataSets("TopEmployees").CommandText |
Representa la colección de conjuntos de datos a los que se hace referencia desde el cuerpo de una definición de informe. No incluye los orígenes de datos que solo se utilizan en encabezados o pies de página. No está disponible en el modo de vista previa local. Para obtener más información, vea Usar referencias a las colecciones DataSources y DataSets (Geerador de informes y SSRS). |
DataSources |
No se muestra | =DataSources("AdventureWorks2012").Type |
Representa la colección de orígenes de datos a los que se hace referencia en el cuerpo de un informe. No incluye los orígenes de datos que solo se utilizan en encabezados o pies de página. No está disponible en el modo de vista previa local. Para obtener más información, vea Usar referencias a las colecciones DataSources y DataSets (Geerador de informes y SSRS). |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
Representa la colección de variables de informe y de variables de grupo. Para más información, vea Referencias a las colecciones de variables de informe y de grupo (Generador de informes y SSRS). |
ReportItems |
No se muestra | =ReportItems("Textbox1").Value |
Representa la colección de cuadros de texto para un elemento de informe. Esta colección se puede usar para resumir los elementos de la página a fin de incluirlos en un encabezado de página o en un pie de página. Para más información, vea Usar referencias a la colección ReportItems (Generador de informes y SSRS). |
Uso de la sintaxis de colección en una expresión
Si desea hacer referencia a una colección desde una expresión, puede usar la sintaxis estándar de Microsoft Visual Basic para los elementos de una colección. En la tabla siguiente se muestran ejemplos de sintaxis de colección.
Sintaxis | Ejemplo |
---|---|
Collection!ObjectName.Property | =Fields!Sales.Value |
Collection!ObjectName("Property") | =Fields!Sales("Value") |
Collection("ObjectName").Property | =Fields("Sales").Value |
Collection("Member") | =User("Language") |
Collection.Member | =User.Language |
Consulte también
Agregar una expresión (Generador de informes y SSRS)
Ejemplos de expresiones (Generador de informes y SSRS)