ToggleDrillState (MDX)

  • Artikel

Schaltet den Drillstatus von Elementen zwischen den Modi für Drilldown und Drillup um.

Syntax

  
ToggleDrillState(Set_Expression1,Set_Expression2 [, [RECURSIVE] [,INCLUDE_CALC_MEMBERS] ] )

Argumente

Set_Expression1
Ein gültiger MDX-Ausdruck (Multidimensional Expressions), der eine Menge zurückgibt.

Set_Expression2
Ein gültiger MDX-Ausdruck (Multidimensional Expressions), der eine Menge zurückgibt.

Rekursive
(Optional). Ein Schlüsselwort, das einen rekursiven Vergleich von Mengen angibt. Die ToggleDrillState-Funktion ist eine Kombination der Funktionen DrillupMember und DrilldownMember . Die Rekursion gilt nur, wenn sich der Member im DrilldownMember-Zustand befindet.

Include_calc_members
(Optional). Ein Flag, das anzeigt, ob berechnete Elemente eingeschlossen werden sollen, wenn sie vorhanden sind (auf Drilldownebene).

Bemerkungen

Die ToggleDrillState-Funktion schaltet den Drillzustand jedes Elements der zweiten Gruppe um, der in der ersten Gruppe vorhanden ist. Die erste Menge kann Tupel beliebiger Dimensionalität aufweisen, die zweite Menge muss jedoch ausschließlich Elemente einer einzigen Dimension enthalten. Die ToggleDrillState-Funktion ist eine Kombination der Funktionen DrillupMember und DrilldownMember . Wenn das Element m der zweiten Menge in der ersten Menge vorhanden ist und dieser Member einen Drilldown ausgeführt wird (d. h. ein Nachfolger folgt), DrillupMember(Set_Expression1, {m}) wird auf das Element oder Tupel in der ersten Menge angewendet. Wenn dieses m-Element hochgebohrt wird (d. h. es gibt keinen Nachfolger von m , der unmittelbar auf m folgt), DrilldownMember(Set_Expression1, {m}[, RECURSIVE]) wird auf die erste Menge angewendet.

Wenn das optionale RECURSIVE-Flag verwendet wird, werden Drillup und Drilldown rekursiv angewendet. Weitere Informationen zum rekursiven Flag finden Sie unter den Funktionen DrillupMember und DrilldownMember .

Durch Abfragen der XMLA-Eigenschaft MdpropMdxDrillFunctions können Sie die Vom Server bereitgestellte Unterstützung für die Drillfunktionen überprüfen. Weitere Informationen finden Sie unter Unterstützte XMLA-Eigenschaften (XMLA).

Szenarien und Beispiele für diese Funktion finden Sie unter Datenbankjournal: MDX Set Functions: Die ToggleDrillState()-Funktion .

Beispiel

Im folgenden Beispiel wird ein Drilldown für das Australia-Element der ersten Menge und ein Drillup für das United States-Element der ersten Menge ausgeführt.

SELECT ToggleDrillState  
   ({[Geography].[Geography].[Country].Members, [Geography].[Geography].[Country].&[United States].Children},  
      {[Geography].[Geography].[Country].[Australia]  
      , [Geography].[Geography].[Country].&[United States]}  
      --, recursive  
      --, include_calc_members  
   ) ON 0  
   FROM [Adventure Works]

Weitere Informationen

MDX-Funktionsreferenz (MDX)