Colecciones integradas en expresiones de un informe paginado (Generador de informes)

Se aplica a: Generador de informes de Microsoft (SSRS) Generador de informes de Power BI Diseñador de informes en SQL Server Data Tools

En una expresión de un informe paginado, puede incluir referencias a las colecciones integradas siguientes: 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 una colección 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 más información, vea Expresiones (Generador de informes).

Nota:

Puede crear y modificar los archivos de definición de informes paginados (.rdl) en el Generador de informes de Microsoft, en Power BI Report Builder y en el Diseñador de informes de SQL Server Data Tools.

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 que distingue mayúsculas de minúsculas para la colección. El nombre figurará si 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
Globales	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, consulte Referencias a campos globales y de usuario integrados (Generador de informes).
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, consulte Referencias a campos globales y de usuario integrados (Generador de informes).
Parámetros	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).
Campos (<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).
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).
DataSources	No se muestra	=DataSources("AdventureWorks2022").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).
Variables	Variables	=Variables!CustomTimeStamp.Value	Representa la colección de variables de informe y de variables de grupo. Para obtener más información, consulte Referencias a las colecciones de variables de informe y de grupo (Generador de informes).
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).

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

Contenido relacionado

Agregar una expresión (Generador de informes)
Ejemplos de expresiones (Generador de informes)