StrToValue (MDX)

Retorna o valor numérico especificado por uma string formatada em Expressões Multidimensionais (MDX).

Sintaxe

  
StrToValue(MDX_Expression [,CONSTRAINED] )   

Argumentos

MDX_Expression
Uma expressão válida de string que resolve, direta ou indiretamente, para uma única célula.

Remarks

A função StrToValue retorna o valor numérico especificado pela expressão MDX. A função StrToValue é tipicamente usada com funções definidas pelo usuário para retornar uma expressão MDX de uma função externa para uma instrução MDX que pode ser resolvida para uma única célula.

  • Quando a flag CONSTRAINED é usada, a expressão MDX deve conter apenas um valor escalar. A bandeira CONSTRAINED é usada para reduzir o risco de ataques de injeção via a string especificada. Se uma expressão MDX for fornecida que não é diretamente resolvível para um valor escalar, o seguinte erro aparece: "As restrições impostas pela flag CONSTRAINED na função STRTOVALUE foram violadas."

  • Quando a flag CONSTRAINED não é usada, a expressão MDX especificada pode ser tão complexa quanto desejado, desde que resolva para uma expressão válida de Expressões Multidimensionais (MDX) que retorne uma única célula.

Note

Devolver o resultado de uma expressão MDX como valor numérico pode ser útil se o valor estiver armazenado como texto e você quiser realizar operações aritméticas nos valores retornados.

Exemplo

O exemplo a seguir usa a função StrToValue para retornar o peso de cada bicicleta como um valor.

WITH MEMBER Measures.x AS   
StrToValue   
   ([Product].[Product].CurrentMember.Properties ('Weight')  
   ,CONSTRAINED  
   )  
SELECT Measures.x ON 0  
,[Product].[Product].[Product].Members ON 1  
FROM [Adventure Works]  
WHERE [Product].[Product Categories].[Bikes]