Funzione Previous (Generatore report 2.0)
Restituisce il valore o il valore di aggregazione specificato per l'istanza precedente di un elemento all'interno dell'ambito specificato.
Sintassi
Previous(expression, scope)
Parametri
expression
(Variant o Binary) Espressione da utilizzare per identificare i dati e per cui recuperare il valore precedente, ad esempio Fields!Fieldname.Value o Sum(Fields!Fieldname.Value).scope
(String) Facoltativo. Nome di un gruppo o di un'area dati oppure valore Null (Nothing in Visual Basic) che specifica l'ambito da cui recuperare il valore precedente specificato da expression. Per ulteriori informazioni sul parametro scope, vedere Utilizzo delle funzioni predefinite di report e aggregazione nelle espressioni (Generatore report 2.0).
Tipo restituito
Restituisce un valore Variant o Binary.
Osservazioni
La funzione Previous restituisce il valore precedente per l'espressione valutata nell'ambito specificato dopo l'applicazione di tutti i criteri di ordinamento e di filtro.
Se expression non contiene un'aggregazione, la funzione Previous viene impostata per impostazione predefinita sull'ambito corrente per l'elemento del report. Per una casella di testo nel gruppo di dettagli, =Previous(Fields!Quantity.Value) restituisce i dati per il campo Quantity dalla riga precedente. Questa espressione nella prima riga restituisce Null (Nothing in Visual Basic).
Se expression contiene una funzione di aggregazione che utilizza un ambito predefinito, Previous aggrega i dati nell'istanza precedente dell'ambito dati specificato nella chiamata alla funzione di aggregazione.
Se expression contiene una funzione di aggregazione che specifica un ambito diverso da quello predefinito, il parametro scope per la funzione Previous deve essere un ambito di contenuto per l'ambito specificato nella chiamata alla funzione di aggregazione.
Le funzioni Level, InScope, Aggregate e Previous non possono essere utilizzate nel parametro expression. Non è possibile specificare il parametro recursive per una funzione di aggregazione.
Esempi
Descrizione
L'esempio di codice seguente, se inserito nella riga di dati predefinita di un'area dati, fornisce il valore per il campo LineTotal nella riga precedente.
Codice
=Previous(Fields!LineTotal.Value)
Descrizione
Nell'esempio seguente è illustrata un'espressione che calcola la somma delle vendite in un giorno del mese specifico e il valore precedente relativo allo stesso giorno del mese in un anno precedente. L'espressione viene aggiunta in una riga di una cella che appartiene al gruppo figlio GroupbyDay. Il gruppo padre è GroupbyMonth, che dispone di un gruppo padre GroupbyYear. L'espressione visualizza i risultati per GroupbyDay (ambito predefinito), quindi per GroupbyYear (elemento padre del gruppo padre GroupbyMonth).
Ad esempio, per un'area dati con un gruppo padre denominato Year che ha un gruppo figlio denominato Month che a sua volta ha un gruppo figlio denominato Day (3 livelli nidificati). L'espressione =Previous(Sum(Fields!Sales.Value,"Day"),"Year") in una riga associata al gruppo Day restituisce il valore delle vendite per lo stesso giorno e mese dell'anno precedente.
Codice
=Sum(Fields!Sales.Value) & " " & Previous(Sum(Fields!Sales.Value,"GroupbyDay"),"GroupbyYear")