InScope-Funktion (Berichts-Generator und SSRS)

Artikel
09/10/2013

Gibt an, ob sich die aktuelle Instanz eines Elements innerhalb des angegebenen Bereichs befindet.

Hinweis
Sie können Berichtsdefinitionen (RDL) in Berichts-Generator und im Berichts-Designer in SQL Server-Datentools erstellen und ändern. Jede Erstellungsumgebung bietet verschiedene Methoden zum Erstellen, Öffnen und Speichern von Berichten und verwandten Elementen. Weitere Informationen finden Sie unter Entwerfen von Berichten in Berichts-Designer und Berichts-Generator (SSRS) im Web auf microsoft.com.

Sie können Berichtsdefinitionen (RDL) in Berichts-Generator und im Berichts-Designer in SQL Server-Datentools erstellen und ändern. Jede Erstellungsumgebung bietet verschiedene Methoden zum Erstellen, Öffnen und Speichern von Berichten und verwandten Elementen. Weitere Informationen finden Sie unter Entwerfen von Berichten in Berichts-Designer und Berichts-Generator (SSRS) im Web auf microsoft.com.

Syntax

InScope(scope)

Parameter

scope
(String) Der Name eines Datasets, eines Datenbereichs oder einer Gruppe, die einen Bereich angibt.

Rückgabetyp

Gibt einen Wert vom Typ Boolean zurück.

Hinweise

Die InScope-Funktion testet den Bereich der aktuellen Instanz eines Berichtselements in Bezug auf die Mitgliedschaft in dem durch den scope-Parameter angegebenen Bereich.

Scope kann kein Ausdruck sein.

Die InScope-Funktion wird üblicherweise in Datenbereichen mit dynamischer Bereichsdefinierung eingesetzt. So kann InScope beispielsweise in einem Drillthroughlink in einer Datenbereichszelle verwendet werden, um unterschiedliche Berichtsnamen und unterschiedliche Parametersätze bereitzustellen, je nach Zelle, auf die Sie klicken. Dies wird im folgenden Beispiel verdeutlicht:

Mit dem folgenden Ausdruck, der in einem Drillthroughlink als Berichtsname verwendet wird, wird der ProductDetail-Bericht geöffnet, wenn sich die angeklickte Zelle in der Month-Gruppierung befindet; andernfalls wird der ProductSummary-Bericht geöffnet.
```
=Iif(InScope("Month"), "ProductDetail", "ProductSummary")
```
Mit dem folgenden Ausdruck, der in der Omit-Eigenschaft eines Drillthroughberichts-Parameters verwendet wird, wird der Parameter nur dann an den Zielbericht übergeben, wenn sich die angeklickte Zelle in der Product-Gruppierung befindet.
```
=Not(InScope("Product"))
```

Weitere Informationen finden Sie unter Aggregatfunktionsreferenz (Berichts-Generator und SSRS) und Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS).

Beispiel

Im folgenden Codebeispiel wird angezeigt, ob sich die aktuelle Instanz des Elements innerhalb des Product-Datasets, -Datenbereichs oder -Gruppenbereichs befindet.