Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Devolve o elemento especificado por uma cadeia formatada em Multidimensional Expressions (MDX).
Syntax
StrToMember(Member_Name [,CONSTRAINED] )
Arguments
Member_Name
Uma expressão de cadeia válida que especifica, direta ou indiretamente, um membro.
Observações
A função StrToMember devolve o membro especificado na expressão da cadeia. A função StrToMember é tipicamente usada com funções definidas pelo utilizador para devolver uma especificação de membro de uma função externa para uma instrução MDX, ou quando uma consulta MDX é parametrizada.
Quando a bandeira CONSTRAINED é usada, o nome do membro deve ser diretamente resolvível para um nome de membro qualificado ou não qualificado. Esta bandeira é usada para reduzir o risco de ataques de injeção através da cadeia especificada. Se for fornecida uma cadeia que não seja diretamente resolvível para um nome de membro qualificado ou não qualificado, aparece o seguinte erro: "As restrições impostas pela bandeira CONSTRAINED na função STRTOMEMBER foram violadas."
Quando a flag CONSTRAINED não é utilizada, o membro especificado pode resolver diretamente para um nome de membro ou para uma expressão MDX que se resolve para um nome.
Para compreender melhor as diferenças entre conjuntos e membros, veja Usar Expressões de Conjunto e Usar Expressões de Membros.
Examples
O exemplo seguinte devolve a medida de Valor de Vendas do Revendedor para o membro Bayern na hierarquia de atributos State-Province usando a função StrToMember . A cadeia especificada fornecia o nome do membro qualificado.
SELECT {StrToMember ('[Geography].[State-Province].[Bayern]')}
ON 0,
{[Measures].[Reseller Sales Amount]} ON 1
FROM [Adventure Works]
O exemplo seguinte devolve a medida do Montante de Vendas do Revendedor para o membro da Bayern usando a função StrToMember . Como a cadeia de nome do membro fornecia apenas um nome de membro não qualificado, a consulta devolve a primeira instância do membro especificado, que por acaso se encontra na hierarquia de Geografia do Cliente na dimensão do Cliente, que não se cruza com as Vendas do Revendedor. As melhores práticas exigem especificar o nome qualificado para garantir os resultados esperados.
SELECT {StrToMember ('[Bayern]').Parent}
ON 0,
{[Measures].[Reseller Sales Amount]} ON 1
FROM [Adventure Works]
O exemplo seguinte devolve a medida de Valor de Vendas do Revendedor para o membro Bayern na hierarquia de atributos State-Province usando a função StrToMember . A cadeia de nomes de membro fornecia resoluções para um nome de membro qualificado.
SELECT {StrToMember('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)}
ON 0,
{[Measures].[Reseller Sales Amount]} ON 1
FROM [Adventure Works]
O exemplo seguinte devolve um erro devido à flag CONSSTRINGED. Embora a cadeia de nomes de membro fornecida contenha uma expressão válida de membro MDX que resolve para um nome de membro qualificado, a bandeira CONSTRAINED requer nomes de membros qualificados ou não qualificados na cadeia de nomes de membros.
SELECT StrToMember ('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)
ON 0
FROM [Adventure Works]