Función First (Generador de informes y SSRS)
Devuelve el primer valor de la expresión especificada en el ámbito especificado.
[!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.
Sintaxis
First(expression, scope)
Parámetros
expression
(Variant o Binary). Expresión en la que se lleva a cabo la agregación, por ejemplo, =Fields!FieldName.Value.scope
(String) (opcional). Nombre de un conjunto de datos, un grupo o una región de datos que contiene los elementos de informe a los que se va a aplicar la función de agregado. Si no se especifica el parámetro scope, se usa el ámbito actual.
Tipo devuelto
Varía según el tipo de expresión.
Comentarios
La función First devuelve el primer valor de un conjunto de datos después de aplicar todos los filtros y la configuración de ordenación al ámbito especificado.
La función First solo se puede usar en expresiones de filtro de grupo con el ámbito actual (valor predeterminado).
También puede usar First en un encabezado de página para devolver el primer valor de la colección ReportItems para una página; esto permite generar encabezados de estilo diccionario que muestren la primera y la última entrada de cada página.
El valor de scope debe ser una constante de cadena y no puede ser una expresión. Para los agregados exteriores o los agregados que no especifican a otros agregados, scope debe hacer referencia al ámbito actual o a un ámbito de contenido. Para los agregados de agregados, los agregados anidados pueden especificar un ámbito secundario.
Expression puede contener las llamadas a las funciones de agregados anidados con las siguientes excepciones y condiciones:
Scope, para los agregados anidados, debe ser igual que el ámbito del agregado exterior, o ser contenido por él. Para todos los ámbitos distintos de la expresión, un ámbito debe estar en una relación secundaria con respecto a todos los otros ámbitos.
Scope, para los agregados anidados, no puede ser el nombre de un conjunto de datos.
Expression no debe contener las funciones First, Last, Previous o RunningValue.
Expression no debe contener a los agregados anidados que especifican recursive.
Para obtener más información, vea Referencia a las funciones de agregado (Generador de informes y SSRS) y Ámbito de expresión para los totales, agregados y colecciones integradas (Generador de informes y SSRS).
Para obtener más información acerca de los agregados recursivos, vea Crear grupos de jerarquía recursiva (Generador de informes y SSRS).
Ejemplo
El siguiente ejemplo de código devuelve el primer número de producto del grupo Category de una región de datos:
=First(Fields!ProductNumber.Value, "Category")
Vea también
Referencia
Ejemplos de expresiones (Generador de informes y SSRS)
Conceptos
Usar expresiones en informes (Generador de informes y SSRS)
Tipos de datos en expresiones (Generador de informes y SSRS)