Freigeben über

InScope-Funktion (Visual Studio-Berichts-Designer)

  • Artikel

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

InScope(Scope)

Parameter

  • Scope
    (String) Der Name einer Datentabelle, eines Objekts, einer Gruppierung oder eines Datenbereichs mit den Berichtselementen, auf die die Funktion angewendet wird.

Rückgabetyp

Gibt einen Wert vom Typ Boolean zurück.

Hinweise

Die InScope-Funktion ist nützlich in Datenbereichen mit dynamischer Bereichsdefinition, z. B. in einer Matrix. So kann InScope beispielsweise in einem Drillthroughlink in einer Matrixzelle verwendet werden, um in Abhängigkeit von der angeklickten Zelle unterschiedliche Berichtsnamen und unterschiedliche Parametersätze bereitzustellen. Das folgende Beispiel verdeutlicht dies:

  • Wenn dieser Ausdruck 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")

  • Wenn dieser Ausdruck in der Omit-Eigenschaft eines Drillthrough-Berichtsparameters verwendet wird, wird der Parameter nur dann an den Zielbericht übergeben, wenn sich die angeklickte Zelle in der Product-Gruppierung befindet.

    =Not(InScope("Product"))

Beispiel

Das folgende Codebeispiel gibt an, ob sich die aktuelle Instanz des Elements innerhalb des Datasets, des Datenbereichs oder der Product-Gruppierung befindet.

InScope("Product")

Siehe auch

Konzepte

Verwenden von Ausdrücken in einem Bericht (Visual Studio-Berichts-Designer)
Hinzufügen von benutzerdefiniertem Code zu einem Bericht (Visual Studio-Berichts-Designer)
ReportViewer-Steuerelemente (Visual Studio)
Integrierte Funktionen für Berichte (Visual Studio-Berichts-Designer)