SetToArray (MDX)

Konvertiert eine Menge oder mehrere Mengen in ein Array zum Verwenden in einer benutzerdefinierten Funktion.

Syntax

  
SetToArray(Set_Expression1 [ ,Set_Expression2,...n ][ ,Numeric_Expression ] )  

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.

Numeric_expression
Ein gültiger numerischer Ausdruck, bei dem es sich in der Regel um einen MDX-Ausdruck (Multidimensional Expressions) für Zellenkoordinaten handelt, die eine Zahl zurückgeben.

Bemerkungen

Die SetToArray-Funktion konvertiert einen oder mehrere Sätze in ein Array zur Verwendung in einer benutzerdefinierten Funktion. Die Anzahl der Dimensionen in dem sich ergebenden Array ist dieselbe wie die Anzahl der angegebenen Mengen.

Durch die optionale Angabe eines numerischen Ausdrucks können die Werte für die Arrayzellen bereitgestellt werden. Wenn kein numerischer Ausdruck angegeben ist, wird der Cross Join der Mengen im aktuellen Kontext ausgewertet.

Die Zellenkoordinaten in dem sich ergebenden Array entsprechen der Position der Mengen in der Liste. Beispielsweise sind drei Mengen, SA, SB und SC, vorhanden. Jede dieser Mengen weist zwei Elemente auf. Die MDX-Anweisung SetToArray(SA, SB, SC) erstellt das folgende dreidimensionale Array:

(SA1, SB1, SC1) (SA2, SB1, SC1) (SA1, SB2, SC1) (SA2, SB2, SC1)   
(SA1, SB1, SC2) (SA2, SB1, SC2) (SA1, SB2, SC2) (SA2, SB2, SC2)   

Hinweis

Der Rückgabetyp der SetToArray-Funktion ist der VARIANT-Typ, VT_ARRAY. Daher sollte die Ausgabe der SetToArray-Funktion nur als Eingabe für eine benutzerdefinierte Funktion verwendet werden.

Beispiel

Im folgenden Beispiel wird ein Array zurückgegeben.

SetToArray([Geography].[Geography].Members, [Measures].[Internet Sales Amount])  

Weitere Informationen

MDX-Funktionsreferenz (MDX)