Funzioni di Generatore report - Funzione FirstReport Builder Functions - First Function

Restituisce il primo valore nell'ambito specificato dell'espressione specificata.Returns the first value in the given scope of the specified expression.

Nota

È possibile creare e modificare file di definizioni report impaginati (con estensione rdl) in Generatore report e in Progettazione report di SQL Server Data Tools.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati.Each authoring environment provides different ways to create, open, and save reports and related items.

SintassiSyntax


First(expression, scope)  

ParametriParameters

espressioneexpression
(Variant o Binary) Espressione su cui eseguire l'aggregazione, ad esempio =Fields!FieldName.Value.(Variant or Binary) The expression on which to perform the aggregation, for example, =Fields!FieldName.Value.

ambitoscope
(String) Facoltativo.(String) Optional. Nome di un set di dati, gruppo o area dati che contiene gli elementi del report a cui applicare la funzione di aggregazione.The name of a dataset, group, or data region that contains the report items to which to apply the aggregate function. Se si omette scope , viene usato l'ambito corrente.If scope is not specified, the current scope is used.

Tipo restituitoReturn Type

Determinato dal tipo di espressione.Determined by the type of expression.

OsservazioniRemarks

La funzione First restituisce il primo valore di un set di dati dopo l'applicazione di tutti i criteri di ordinamento e di filtro all'ambito specificato.The First function returns the first value in a set of data after all sorting and filtering have been applied at the specified scope.

La funzione First non può essere usata in espressioni di filtro di gruppo con altri ambiti ad eccezione dell'ambito corrente (predefinito).The First function cannot be used in group filter expressions with anything except the current (default) scope.

È anche possibile usare First in un'intestazione di pagina per restituire il primo valore della raccolta ReportItems per una pagina, in modo da creare intestazioni in formato dizionario che visualizzano la prima e l'ultima voce di una pagina.You can also use First in a page header to return the first value from the ReportItems collection for a page in order to produce dictionary-style headings that display the first and last entries on a page.

Il valore di scope deve essere una costante di tipo stringa e non può essere un'espressione.The value of scope must be a string constant andcannot be an expression. Per aggregazioni o aggregazioni esterne che non specificano altre aggregazioni, scope deve fare riferimento all'ambito corrente o a un ambito contenitore.For outer aggregates or aggregates that do not specify other aggregates, scope must refer to the current scope or a containing scope. Per le aggregazioni di aggregazioni, le aggregazioni nidificate possono specificare un ambito figlio.For aggregates of aggregates, nested aggregates can specify a child scope.

Expression può contenere chiamate alle funzioni di aggregazione nidificate con le eccezioni e le condizioni seguenti:Expression can contain calls to nested aggregate functions with the following exceptions and conditions:

EsempioExample

L'esempio di codice seguente restituisce il primo numero di prodotto nel gruppo o nell'area dati Category :The following code example returns the first product number in the Category group of a data region:

=First(Fields!ProductNumber.Value, "Category")  

Vedere ancheSee Also

Utilizzo delle espressioni nei report (Generatore report e SSRS) Expression Uses in Reports (Report Builder and SSRS)
Esempi di espressioni (Generatore report e SSRS) Expression Examples (Report Builder and SSRS)
Tipi di dati nelle espressioni (Generatore report e SSRS) Data Types in Expressions (Report Builder and SSRS)
Ambito di espressioni per totali, aggregazioni e raccolte predefinite (Generatore report e SSRS)Expression Scope for Totals, Aggregates, and Built-in Collections (Report Builder and SSRS)