ToggleDrillState (MDX)
Schaltet den Drillstatus von Elementen zwischen den Modi 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.Recursive
(Optional). Ein Schlüsselwort, das einen rekursiven Vergleich von Mengen angibt. Die ToggleDrillState-Funktion ist eine Kombination der Funktionen DrillupMember und DrilldownMember. Rekursion gilt nur, wenn sich das Element im Status DrilldownMember befindet.Include_calc_members
(Optional). Ein Flag, das anzeigt, ob berechnete Elemente in die Ebene aufgenommen werden sollen, auf die die Elemente heruntergebracht werden.
Hinweise
Die ToggleDrillState-Funktion schaltet den Drillstatus für jedes Element der zweiten Menge um, das in der ersten Menge 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 enthalten ist und für dieses Element ein Drilldown ausgeführt wird (d. h., es ist ein nachfolgender Wert von m vorhanden, der m unmittelbar folgt), wird DrillupMember(Set_Expression1, {m}) auf die Elemente oder Tupel in der ersten Menge angewendet. Wenn für das Element m ein Drillup ausgeführt wird (d. h., es ist kein nachfolgender Wert von m vorhanden, der m unmittelbar folgt), wird DrilldownMember(Set_Expression1, {m}[, RECURSIVE]) auf die erste Menge angewendet.
Wenn das optionale RECURSIVE-Flag verwendet wird, werden Drillup und Drilldown rekursiv angewendet. Weitere Informationen zum Recursive-Flag finden Sie in den Abschnitten zu den Funktionen DrillupMember und DrilldownMember.
Mithilfe einer Abfrage der XMLA-Eigenschaft MdpropMdxDrillFunctions können Sie ermitteln, inwieweit der Server die Drillingfunktionen unterstützt. Weitere Informationen finden Sie unter Unterstützte XMLA-Eigenschaften (XMLA).
Szenarien und Beispiele mit dieser Funktion finden Sie unter Datenbankjournal: MDX-Set-Funktionen: Die Funktion ToggleDrillState().
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]