Compartilhar via


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]  

Consulte Também

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