Usar las colecciones integradas en expresiones (Generador de informes 3.0 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, vea Expresiones (Generador de informes 3.0 y SSRS).
Nota
Puede crear y modificar las definiciones de informe (.rdl) en el Generador de informes 3.0 y en el Diseñador de informes en Business Intelligence Development Studio. 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 3.0 y el Administrador de informes (SSRS) en el sitio web 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 Usar referencias a colecciones Globals y User integradas (Generador de informes 3.0 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 Usar referencias a colecciones Globals y User integradas (Generador de informes 3.0 y SSRS). |
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 (Generador de informes 3.0 y SSRS). |
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 (Generador de informes 3.0 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 (Generador de informes 3.0 y SSRS). |
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 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 (Generador de informes 3.0 y SSRS). |
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 (Generador de informes 3.0 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 obtener más información, vea Usar las referencias a la colección ReportItems (Generador de informes 3.0 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 |
Pasar colecciones integradas a ensamblados personalizados
Si desea pasar colecciones integradas a un ensamblado personalizado para procesar, debe agregar una referencia de ensamblado de su proyecto de código al ensamblado que defina las recopilaciones integradas y acceda al espacio de nombres correcto. Dependiendo de si desarrolla el ensamblado personalizado para un informe que se ejecuta en un servidor de informes (informe de servidor) o para un informe que se ejecuta localmente en una aplicación .NET (informe local), el ensamblado al que debe hacerse referencia será diferente. A continuación se incluye información detallada.
Espacio de nombres: Microsoft.ReportingServices.ReportProcessing.ReportObjectModel
Ensamblado (informe local): Microsoft.ReportingServices.ProcessingObjectModel.dll
Ensamblado (informe de servidor): Microsoft.ReportViewer.ProcessingObjectModel.dll
Como el contenido de las colecciones Fields y ReportItems puede cambiar dinámicamente en tiempo de ejecución, no debe incluirlas en las llamadas al ensamblado personalizado (por ejemplo, en una variable miembro). La misma recomendación se aplica normalmente a todas las colecciones integradas.
Vea también