StrToValue (MDX)
Retorna o valor numérico especificado por uma cadeia de caracteres formatada em MDX (Multidimensional Expressions).
Sintaxe
StrToValue(MDX_Expression [,CONSTRAINED] )
Argumentos
MDX_Expression
Uma expressão de cadeia de caracteres válida que resolve, direta ou indiretamente, uma célula única.
Comentários
A função StrToValue retorna o valor numérico especificado pela expressão MDX. A função StrToValue normalmente é usada com funções definidas pelo usuário para retornar uma expressão MDX de uma função externa de volta para uma instrução MDX que pode ser resolvida para uma única célula.
Quando o sinalizador CONSTRAINED for usado, a expressão MDX deverá conter somente um valor de escalar. O sinalizador CONSTRAINED é usado para reduzir o risco de ataques de injeção pela cadeia de caracteres especificada. Se uma linguagem MDX fornecida não for resolvida diretamente com um valor escalar; surge o seguinte erro: "As restrições impostas pelo sinalizador CONSTRAINED na função STRTOVALUE foram violadas."
Quando o sinalizador CONSTRAINED não for usado, a linguagem MDX especificada pode ser tão complexa quanto se desejar, desde que resolva a uma linguagem MDX válida que retorne uma célula única.
Observação
Retornar o resultado de uma linguagem MDX como um valor numérico pode ser útil se o valor for armazenado como texto e você quiser executar 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]