Usar las colecciones integradas en expresiones (Generador de informes 2.0)
Reporting Services pone a su disposición las siguientes colecciones integradas, a las que puede hacer referencia en una expresión: ReportItems, Parameters, Fields, DataSets, DataSources, Variables y campos integrados que proporcionan 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 obtener más información, vea Descripción de las referencias a expresiones (Generador de informes 2.0).
Descripción de las colecciones integradas
La tabla siguiente contiene una lista de las colecciones integradas disponibles en Reporting Services. 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 Usar referencias a campos integrados en expresiones (Generador de informes 2.0). |
User |
Campos integrados |
=User.UserID O bien =User.Language |
Representa una colecció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 Usar referencias a campos integrados en expresiones (Generador de informes 2.0). |
Parameters |
Parameters |
=Parameters("ReportMonth").Value O bien =Parameters!ReportYear.Value |
Representa la colección de parámetros de informe. Cada uno de ellos puede tener uno o varios valores. No está disponible hasta que la inicialización se ha completado. Para obtener más información, vea Usar referencias a la colección de parámetros en expresiones (Generador de informes 2.0). |
Fields(<Dataset>) |
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 Usar referencias a la colección de campos de conjunto de datos en expresiones (Generador de informes 2.0). |
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 sólo 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 en expresiones (Generador de informes 2.0). |
DataSources |
No se muestra |
=DataSources("AdventureWorks").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 sólo 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 en expresiones (Generador de informes 2.0). |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
Representa la colección de variables de informe y de variables de grupo. Para obtener más información, vea Usar referencias a las colecciones de variables de informe y de grupo en expresiones (Generador de informes 2.0). |
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 obtener más información, vea Usar referencias a la colección ReportItems en expresiones (Generador de informes 2.0). |
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 MicrosoftVisual 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 |
Vea también