StrToValue (MDX)
Retorna o valor numérico especificado por uma linguagem MDX – cadeia de caracteres formatada.
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 linguagem MDX. Normalmente, a função StrToValue é usada com funções definidas pelo usuário para retornar uma linguagem MDX a partir de uma função externa de volta para uma instrução MDX que pode ser resolvida em uma célula única.
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.
Dica
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]