Freigeben über

InScope-Funktion (Berichts-Generator und SSRS)

Gibt an, ob sich die aktuelle Instanz eines Elements im angegebenen Bereich befindet.

Hinweis

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

Syntax

InScope(scope)

Die Parameter

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

Rückgabetyp

Gibt einen Wert vom Typ Boolean zurück.

Bemerkungen

Die InScope Funktion testet den Bereich der aktuellen Instanz eines Berichtselements darauf, ob es sich um eine Mitgliedschaft im Bereich handelt, der durch den Bereichsparameter angegeben wird.

Scope darf kein Ausdruck sein.

Eine typische Verwendung für die InScope Funktion befindet sich in Datenbereichen mit dynamischer Bereichsdefinition. Beispielsweise kann InScope in einem Drillthrough-Link in den Zellen eines Datenbereichs verwendet werden, um einen anderen Berichtsnamen und unterschiedliche Parametersätze bereitzustellen, je nachdem, auf welche Zelle geklickt wird. 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")

  • Der folgende Ausdruck, der in der Omit Eigenschaft eines Drillthrough-Berichtsparameters verwendet wird, übergibt den Parameter nur dann an den Zielbericht, wenn sich die geklickte Zelle in der Product Gruppe befindet.

    =Not(InScope("Product"))

Weitere Informationen finden Sie in der Aggregatfunktionsreferenz (Berichts-Generator und SSRS) und unter 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.

=InScope("Product")

Siehe auch

Ausdrucksverwendungen in Berichten (Berichts-Generator und SSRS)
Beispiele für Ausdrücke (Berichts-Generator und SSRS)
Datentypen in Ausdrücken (Berichts-Generator und SSRS)
Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS)

  • Last updated on