Funzioni Generatore report - Funzione First in un report impaginato (Generatore report)

Si applica a:✅ Generatore di report Microsoft (SSRS) ✅ Power BI Report Builder ✅ Report Designer in SQL Server Data Tools

Restituisce il primo valore nell'ambito specificato dell'espressione specificata in un report impaginato.

Nota

È possibile creare e modificare file di definizioni di report impaginati (con estensione rdl) in Generatore report di Microsoft, Power BI Report Builder e Progettazione report di SQL Server Data Tools.

Sintassi

  
First(expression, scope)  

Parametri

expression
(Variant o Binary) Espressione su cui eseguire l'aggregazione, ad esempio =Fields!FieldName.Value.

ambito
(String) Facoltativo. Nome di un set di dati, gruppo o area dati che contiene gli elementi del report a cui applicare la funzione di aggregazione. Se si omette scope , viene usato l'ambito corrente.

Tipo restituito

Determinato dal tipo di espressione.

Osservazioni:

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.

La funzione First non può essere usata in espressioni di filtro di gruppo con altri ambiti ad eccezione dell'ambito corrente (predefinito).

È 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.

Il valore di scope deve essere una costante di tipo stringa e non può essere un'espressione. Per aggregazioni o aggregazioni esterne che non specificano altre aggregazioni, scope deve fare riferimento all'ambito corrente o a un ambito contenitore. Per le aggregazioni di aggregazioni, le aggregazioni nidificate possono specificare un ambito figlio.

Expression può contenere chiamate alle funzioni di aggregazione nidificate con le eccezioni e le condizioni seguenti:

• Scope per le aggregazioni nidificate deve corrispondere o essere contenuto nell'ambito dell'aggregazione esterna. Per tutti gli ambiti distinti nell'espressione, un ambito deve essere in una relazione figlio con tutti gli altri ambiti.

• Scope per le aggregazioni nidificate non può essere il nome di un set di dati.

• Expression non deve contenere funzioni First, Last, Previouso RunningValue .

• Expression non deve contenere aggregazioni nidificate che specificano recursive.

Per altre informazioni, vedere Riferimento a funzioni di aggregazione (Generatore report e SSRS) e Ambito di espressioni per totali, aggregazioni e raccolte predefinite (Generatore report e SSRS).

Per altre informazioni sulle aggregazioni ricorsive, vedere Creazione di gruppi di gerarchie ricorsive (Generatore report e SSRS).

Esempio

L'esempio di codice seguente restituisce il primo numero di prodotto nel gruppo o nell'area dati Category :

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

Vedi anche

Utilizzo delle espressioni nei report (Generatore di report e SSRS)
Esempi di espressioni (Generatore di report e SSRS)
Tipi di dati nelle espressioni (Generatore di report e SSRS)
Ambito di espressioni per totali, aggregazioni e raccolte predefinite (Generatore di report e SSRS)