Funzioni di Generatore report - riferimento a funzioni di aggregazioneReport Builder Functions - Aggregate Functions Reference

Per includere valori aggregati nel report, è possibile utilizzare funzioni di aggregazione predefinite nelle espressioni.To include aggregated values in your report, you can use built-in aggregate functions in expressions. La funzione di aggregazione predefinita per i campi numerici è SUM.The default aggregate function for numeric fields is SUM. È possibile modificare l'espressione e utilizzare una funzione di aggregazione predefinita o specificare un ambito differente.You can edit the expression and use a different built-in aggregate function or specify a different scope. L'ambito identifica il set di dati da utilizzare per il calcolo.Scope identifies which set of data to use for the calculation.

Quando l'elaboratore di report combina i dati e il layout del report, le espressioni per ogni elemento del report vengono valutate.As the report processor combines report data and the report layout, the expressions for each report item are evaluated. Insieme a ogni pagina del report vengono visualizzati i risultati per ogni espressione negli elementi del report visualizzabile.As you view each page of the report, you see the results for each expression in the rendered report items.

Nella tabella seguente sono elencate le categorie di funzioni predefinite supportate che possono essere incluse in un'espressione:The following table lists categories of built-in functions that you can include in an 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.

Funzioni di aggregazione predefinite Built-in Aggregate Functions

Le funzioni predefinite seguenti calcolano i valori di riepilogo relativi a un set di dati numerici non Null nell'ambito predefinito o nell'ambito denominato.The following built-in functions calculate summary values for a set of non-null numeric data in the default scope or the named scope.

FunzioneFunction DescriptionDescription
AvgAvg Restituisce la media di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato.Returns the average of all non-null numeric values specified by the expression, evaluated in the given scope.
CountCount Restituisce il conteggio dei valori non Null specificati dall'espressione, valutato nel contesto dell'ambito specificato.Returns a count of non-null values specified by the expression, evaluated in the context of the given scope.
CountDistinctCountDistinct Restituisce un conteggio di tutti i distinti valori non Null specificati dall'espressione, valutato nel contesto dell'ambito specificato.Returns a count of all distinct non-null values specified by the expression, evaluated in the context of the given scope.
MaxMax Restituisce il valore massimo di tutti i valori numerici non Null specificati dall'espressione, nel contesto dell'ambito specificato.Returns the maximum value of all non-null numeric values specified by the expression, in the context of the given scope. È possibile utilizzare questa funzione per specificare il valore massimo di un asse del grafico per controllare la scala.You can use this for specifying a chart axis maximum value to control the scale.
MinMin Restituisce il valore minimo di tutti i valori numerici non Null specificati dall'espressione, nel contesto dell'ambito specificato.Returns the minimum value of all non-null numeric values specified by the expression, in the context of the given scope. È possibile utilizzare questa funzione per specificare il valore minimo di un asse del grafico per controllare la scala.You can use this for specifying a chart axis minimum value to control the scale.
StDevStDev Restituisce la deviazione standard di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato.Returns the standard deviation of all non-null numeric values specified by the expression, evaluated in the given scope.
StDevPStDevP Restituisce la deviazione standard di popolazione di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato.Returns the population standard deviation of all non-null numeric values specified by the expression, evaluated in the context of the given scope.
SumSum Restituisce la somma di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato.Returns the sum of all the non-null numeric values specified by the expression, evaluated in the given scope.
UnionUnion Restituisce l'unione di tutti i valori di dati spaziali non Null di tipo SqlGeometry o SqlGeography specificati dall'espressione, valutati nell'ambito specificato.Returns the union of all the non-null spatial data values of type SqlGeometry or SqlGeography that are specified by the expression, evaluated in the given scope.
VarVar Restituisce la varianza di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato.Returns the variance of all non-null numeric values specified by the expression, evaluated in the given scope.
VarPVarP Viene restituita la varianza della popolazione di tutti i valori numerici non Null specificati dall'espressione, valutata nel contesto dell'ambito specificato.Returns the population variance of all non-null numeric values specified by the expression, evaluated in the context of the given scope.

Icona freccia usata con Back collegamento Torna all'iniziotorna all'inizioArrow icon used with Back to Top linkBack to Top

Restrizioni relative a campi, raccolte e funzioni di aggregazione predefiniti Restrictions on Built-in Fields, Collections, and Aggregate Functions

Nella tabella seguente sono riepilogate le restrizioni nei percorsi del report in cui è possibile aggiungere espressioni contenenti riferimenti alle raccolte predefinite globali.The following table summarizes restrictions in report locations on where you can add expressions that contain references to global built-in collections.

Percorso nel reportLocation in Report CampiFields ParametriParameters ReportItemsReportItems PageNumberPageNumber

TotalPagesTotalPages
DataSourceDataSource

DataSetDataSet
VariabiliVariables RenderFormatRenderFormat
Intestazione di paginaPage Header

Piè di paginaPage Footer
Yes Yes Al massimo unoAt most one

Nota 1Note 1
Yes Yes Yes Yes
CorpoBody Yes

Nota 2Note 2
Yes Solo elementi nell'ambito corrente o in un ambito contenitoreOnly items in the currnet scope or a containing scope

Nota 3Note 3
NoNo Yes Yes Yes
Parametro del reportReport Parameter NoNo Solo i parametri precedenti dell'elencoOnly parameters earlier in the list

Nota 4Note 4
NoNo NoNo NoNo NoNo NoNo
CampoField Yes Yes NoNo NoNo NoNo NoNo NoNo
Parametro della queryQuery Parameter NoNo Yes NoNo NoNo NoNo NoNo NoNo
Espressione di raggruppamentoGroup Expression Yes Yes NoNo NoNo Yes NoNo NoNo
Espressione di ordinamentoSort Expression Yes Yes NoNo NoNo Yes Yes

Nota 5Note 5
NoNo
Espressione filtroFilter Expression Yes Yes NoNo NoNo Yes Yes

Nota 6Note 6
NoNo
codiceCode NoNo Yes

Nota 7Note 7
NoNo NoNo NoNo NoNo NoNo
Lingua del reportReport.Language NoNo Yes NoNo NoNo NoNo NoNo NoNo
VariabiliVariables Yes Yes NoNo NoNo Yes Ambito corrente o contenitoreCurrent or containing scope NoNo
AggregazioniAggregates Yes Yes Solo nell'intestazione di pagina/piè di paginaOnly in page header/page footer Solo nelle aggregazioni dell'elemento del reportOnly in report item aggregates Yes NoNo NoNo
Funzioni di ricercaLookup functions Yes Yes Yes NoNo Yes NoNo NoNo
  • Nota 1.Note 1. ReportItems deve essere incluso nella pagina del report visualizzabile; in caso contrario, il relativo valore è Null.ReportItems must exist in the rendered report page, or their value is Null. Se la visibilità di un elemento del report dipende da un'espressione che restituisce False, l'elemento del report non sarà presente nella pagina.If the visibility of a report item depends on an expression that evaluates to False, the report item does not exist on the page.

  • Nota 2.Note 2. Se un riferimento a un campo viene usato in un ambito del gruppo e non è incluso nell'espressione di raggruppamento, il valore per il campo non è definito, a meno che nell'ambito non sia presente un solo valore.If a field reference is used in a group scope, and the field reference is not included in the group expression, then the value for the field is undefined, unless there is only one value in the scope. Per specificare un valore, usare First o Last e l'ambito del gruppo.To specify a value, use First or Last and the group scope.

  • Nota 3.Note 3. Le espressioni che includono un riferimento a ReportItems possono specificare valori per altri parametri ReportItems nello stesso ambito del gruppo o in un ambito del gruppo contenitore.Expressions that include a reference to ReportItems can specify values for other ReportItems in the same group scope or in a containing group scope.

  • Nota 4.Note 4. I valori della proprietà per i parametri precedenti possono essere Null.Property values for earlier parameters might be null.

  • Nota 5.Note 5. Solo negli ordinamenti di membri.In Member sorts only. Non può essere usata nelle espressioni di ordinamento dell'area dati.Cannot use in data region sort expressions.

  • Nota 6.Note 6. Solo nei filtri di membri.In Member filters only. Non può essere usata in espressioni dei filtri dell'area dati o del set di dati.Cannot use in data region or dataset filter expressions.

  • Nota 7.Note 7. La raccolta di parametri non viene inizializzata fino al termine dell'elaborazione del blocco di codice, di conseguenza non è possibile usare i metodi per controllare i parametri durante l'inizializzazione.The Parameters collection is not initialized until after the Code block is processed, so methods cannot be used to control parameters on initialization.

  • Nota 8.Note 8. In tutte le aggregazioni, ad eccezione di Count e CountDistinct, i tipi di dati devono essere analoghi per tutti i valori oppure essere Null.Data type for all aggregates except Count and CountDistinct must be the same data type, or null, for all values.

    Icona freccia usata con Back collegamento Torna all'iniziotorna all'inizioArrow icon used with Back to Top linkBack to Top

Restrizioni relative alle aggregazioni nidificate Restrictions on Nested Aggregates

Nella tabella seguente vengono riepilogate le restrizioni sulle funzioni di aggregazione che consentono la specifica di altre funzioni di aggregazione come aggregazioni nidificate.The following table summarizes restrictions on which aggregates functions can specify other aggregate functions as nested aggregates.

ContestoContext RunningValueRunningValue RowNumberRowNumber PrimoFirst

UltimoLast
PreviousPrevious Sum e altre funzioni di ordinamento preliminareSum and Other Presort functions Aggregazioni ReportItemReportItem aggregates Funzioni di ricercaLookup functions Funzione di aggregazioneAggregate Function
Valore correnteRunning Value NoNo NoNo NoNo NoNo Yes NoNo Yes NoNo
PrimoFirst

UltimoLast
NoNo NoNo NoNo NoNo Yes NoNo NoNo NoNo
PreviousPrevious Yes Yes Yes NoNo Yes NoNo Yes NoNo
Sum e altre funzioni di ordinamento preliminareSum and other Presort functions NoNo NoNo NoNo NoNo Yes NoNo Yes NoNo
Aggregazioni ReportItemReportItem aggregates NoNo NoNo NoNo NoNo NoNo NoNo NoNo NoNo
Funzioni di ricercaLookup functions Yes Yes

Nota 1Note 1
Yes

Nota 1Note 1
Yes

Nota 1Note 1
Yes

Nota 1Note 1
Yes

Nota 1Note 1
NoNo NoNo
Funzione di aggregazioneAggregate Function NoNo NoNo NoNo NoNo NoNo NoNo NoNo NoNo
  • Nota 1.Note 1. Le funzioni di aggregazione sono consentite solo all'interno dell'espressione Source di una funzione di ricerca se tale funzione non è contenuta in un'aggregazione.Aggregate functions are only allowed inside the Source expression of a Lookup function if the Lookup function is not contained in an aggregate. Le funzioni di aggregazione non sono consentite all'interno di espressioni Destination o Result di una funzione di ricerca.Aggregate functions are not allowed inside the Destination or Result expressions of a Lookup function.

    Icona freccia usata con Back collegamento Torna all'iniziotorna all'inizioArrow icon used with Back to Top linkBack to Top

Calcolo dei valori correnti Calculating Running Values

Nelle funzioni predefinite seguenti vengono calcolati i valori correnti per un set di dati.The following built-in functions calculate running values for a set of data. RowNumber è simile a RunningValue in quanto consente la restituzione del valore corrente di un conteggio che viene incrementato per ogni riga all'interno dell'ambito contenitore.RowNumber is like RunningValue in that it returns the running value of a count that increments for each row within the containing scope. Il parametro di ambito per queste funzioni deve specificare un ambito contenitore che controlla quando deve essere riavviato il conteggio.The scope parameter for these functions must specify a containing scope, which controls when the count restarts.

FunzioneFunction DescriptionDescription
RowNumberRowNumber Restituisce il conteggio parziale del numero di righe per l'ambito specificato.Returns a running count of the number of rows for the specified scope. La funzione RowNumber riavvia il conteggio da 1, non da 0.The RowNumber function restarts counting at 1, not 0.
RunningValueRunningValue Restituisce un'aggregazione parziale di tutti i valori numerici non Null specificati dall'espressione, valutata per l'ambito specificato.Returns a running aggregate of all non-null numeric values specified by the expression, evaluated for the given scope.

Icona freccia usata con Back collegamento Torna all'iniziotorna all'inizioArrow icon used with Back to Top linkBack to Top

Recupero di conteggi delle righe Retrieving Row Counts

La funzione predefinita seguente calcola il numero di righe nell'ambito specificato.The following built-in function calculates the number of rows in the given scope. Utilizzare questa funzione per conteggiare tutte le righe, incluse quelle con valori Null.Use this function to count all rows, including rows with null values.

FunzioneFunction DescriptionDescription
CountRowsCountRows Restituisce il numero di righe nell'ambito specificato, incluse le righe con valori Null.Returns the number of rows in the specified scope, including rows with null values.

Icona freccia usata con Back collegamento Torna all'iniziotorna all'inizioArrow icon used with Back to Top linkBack to Top

Ricerca di valori da un altro set di dati Looking Up Values from Another Dataset

Le funzioni di ricerca seguenti recuperano valori da un set di dati specificato.The following lookup functions retrieve values from a specified dataset.

FunzioneFunction DescriptionDescription
Funzione LookupLookup Function Restituisce un valore da un set di dati per un'espressione specificata.Returns a value from a dataset for a specified expression.
Funzione LookupSetLookupSet Function Restituisce un set di valori da un set di dati per un'espressione specificata.Returns a set of values from a dataset for a specified expression.
Funzione MultilookupMultilookup Function Restituisce il set di valori di prima corrispondenza per un set di nomi da un set di dati che contiene coppie nome/valore.Returns the set of first-match values for a set of names from a dataset that contains name/value pairs.

Icona freccia usata con Back collegamento Torna all'iniziotorna all'inizioArrow icon used with Back to Top linkBack to Top

Recupero di valori dipendenti dall'ordinamento Retrieving Sort-Dependent Values

Le funzioni predefinite seguenti restituiscono il primo, l'ultimo o il precedente valore all'interno di un ambito specificato.The following built-in functions return the first, last, or previous value within a given scope. Queste funzioni dipendono dal tipo di ordinamento dei valori dei dati.These functions depend on the sort order of the data values. Utilizzare queste funzioni, ad esempio, per trovare il primo e l'ultimo valore in una pagina o per creare un'intestazione di pagina in formato dizionario.Use these functions, for example, to find the first and last values on a page to create a dictionary-style page header. Usare Previous per confrontare il valore di una riga con il valore della riga precedente in un ambito specificato, ad esempio per trovare i valori in percentuale anno dopo anno in una tabella.Use Previous to compare a value in one row to the previous row's value within a specific scope, for example, to find percentage year over year values in a table.

FunzioneFunction DescriptionDescription
PrimoFirst Restituisce il primo valore nell'ambito specificato dell'espressione specificata.Returns the first value in the given scope of the specified expression.
UltimoLast Restituisce l'ultimo valore nell'ambito specificato dell'espressione specificata.Returns the last value in the given scope of the specified expression.
PreviousPrevious Restituisce il valore o il valore di aggregazione specificato per l'istanza precedente di un elemento all'interno dell'ambito specificato.Returns the value or the specified aggregate value for the previous instance of an item within the specified scope.

Icona freccia usata con Back collegamento Torna all'iniziotorna all'inizioArrow icon used with Back to Top linkBack to Top

Recupero di aggregazioni server Retrieving Server Aggregates

La funzione predefinita seguente recupera aggregazioni personalizzate dal provider di dati.The following built-in function retrieves custom aggregates from the data provider. Ad esempio, usando un tipo di origine dati di Analysis ServicesAnalysis Services , è possibile recuperare le aggregazioni calcolate sul server dell'origine dati da usare in un'intestazione di gruppo.For example, using an Analysis ServicesAnalysis Services data source type, you can retrieve aggregates calculated on the data source server for use in a group header.

FunzioneFunction DescriptionDescription
AggregateAggregate Restituisce un'aggregazione personalizzata dell'espressione specificata, secondo quanto definito dal provider di dati.Returns a custom aggregate of the specified expression, as defined by the data provider.

Icona freccia usata con Back collegamento Torna all'iniziotorna all'inizioArrow icon used with Back to Top linkBack to Top

Verifica dell'ambito Testing for Scope

La funzione predefinita seguente controlla il contesto corrente di un elemento del report per verificare se è un membro di un ambito specifico.The following built-in function tests the current context of a report item to see if it is a member of a specific scope.

FunzioneFunction DescriptionDescription
InScopeInScope Indica se l'istanza corrente di un elemento è inclusa nell'ambito specificato.Indicates whether the current instance of an item is within the specified scope.

Icona freccia usata con Back collegamento Torna all'iniziotorna all'inizioArrow icon used with Back to Top linkBack to Top

Recupero del livello ricorsivo Retrieving Recursive Level

La funzione predefinita seguente recupera il livello corrente quando viene elaborata una gerarchia ricorsiva.The following built-in function retrieves the current level when a recursive hierarchy is processed. Usare il risultato di questa funzione con la proprietà Padding in una casella di testo per controllare il livello di rientro di una gerarchia visiva per un gruppo ricorsivo.Use the result of this function with the Padding property in a text box to control the indent level of a visual hierarchy for a recursive group. Per altre informazioni, vedere Creare un gruppo di gerarchie ricorsive (Generatore report e SSRS).For more information, see Creating Recursive Hierarchy Groups (Report Builder and SSRS).

FunzioneFunction DescriptionDescription
LevelLevel Restituisce il livello di nidificazione corrente in una gerarchia ricorsiva.Returns the current level of depth in a recursive hierarchy.

Icona freccia usata con Back collegamento Torna all'iniziotorna all'inizioArrow icon used with Back to Top linkBack to Top

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)
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)