SetToArray (MDX)

Converte um ou mais conjuntos para uma matriz para uso em uma função definida pelo usuário.

Sintaxe

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

Argumentos

• Set_Expression1
  Uma linguagem MDX válida que retorna um conjunto.

• Set_Expression2
  Uma linguagem MDX válida que retorna um conjunto.

• Numeric_Expression
  Uma expressão numérica válida, geralmente uma linguagem MDX de coordenadas de célula, que retorna um número.

Comentários

A função SetToArray converte um ou mais conjuntos para uma matriz para uso em uma função definida pelo usuário. O número de dimensões na matriz resultante é igual ao número de conjuntos especificados.

A expressão numérica opcional pode fornecer os valores nas células da matriz. Se uma expressão numérica não for especificada, a junção cruzada dos conjuntos será avaliada no contexto atual.

As coordenadas da célula na matriz resultante correspondem à posição dos conjuntos na lista. Por exemplo, há três conjuntos: SA, SB e SC. Cada um desses conjuntos tem dois elementos. A instrução MDX, SetToArray(SA, SB, SC), cria a matriz tridimensional a seguir:

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

Observação
O tipo de retorno da função SetToArray é o tipo de VARIANTE, VT_ARRAY. Portanto, a saída da função SetToArray só deve ser usada como entrada para uma função definida pelo usuário.

Exemplo

O exemplo a seguir retorna uma matriz.

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

Consulte também

Referência

Referência de função MDX (MDX)