Partilhar via


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.

ObservaçãoObservaçã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]

Consulte também

Referência