SetToArray (MDX)

Aktualisiert: 17. Juli 2006

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, der eine Zahl zurückgibt.

Hinweise

Die SetToArray-Funktion konvertiert eine oder mehrere Mengen in ein Array zum Verwenden 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 das kartesische Produkt 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])

Siehe auch

Verweis

MDX-Funktionsreferenz (MDX)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version	Verlauf
17. Juli 2006	Geänderter Inhalt: Syntax und Argumente wurden zur Verdeutlichung aktualisiert. Aktualisierte Beispiele wurden hinzugefügt.