Funzione InScope (Generatore report e SSRS)

Articolo
05/07/2013

Indica se l'istanza corrente di un elemento è inclusa nell'ambito specificato.

[!NOTA]

È possibile creare e modificare definizioni del report (con estensione rdl) in Generatore report e in Progettazione report di SQL Server Data Tools. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati. Per ulteriori informazioni, vedere Progettazione di report tramite Progettazione report e Generatore report (SSRS) nel Web all'indirizzo microsoft.com.

Sintassi

InScope(scope)

Parametri

scope
(String) Nome di un set di dati, area dati o gruppo che specifica un ambito.

Tipo restituito

Restituisce un valore Boolean.

Osservazioni

La funzione InScope testa l'ambito dell'istanza corrente di un elemento del report per verificare l'appartenenza nell'ambito specificato dal parametro scope.

Scope non può essere un'espressione.

La funzione InScope viene tipicamente utilizzata nelle aree dati con ambito dinamico. È ad esempio possibile utilizzare InScope in un collegamento drill-through nelle celle di un'area dati per specificare un nome di report diverso e set di parametri diversi a seconda della cella su cui si fa clic. Di seguito viene riportato un esempio:

L'espressione seguente, utilizzata come nome del report in un collegamento drill-through, apre il report ProductDetail se la cella su cui viene fatto clic si trova nel gruppo Month e il report ProductSummary in caso contrario.
```
=Iif(InScope("Month"), "ProductDetail", "ProductSummary")
```
L'espressione seguente, utilizzata nella proprietà Omit di un parametro di report drill-through, passerà il parametro al report di destinazione solo se la cella su cui viene fatto clic si trova nel gruppo Product.
```
=Not(InScope("Product"))
```

Per ulteriori 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).