Compartilhar via

Properties (MDX)

  • Artigo

Retorna uma cadeia de caracteres ou um valor com rigidez de tipos que contém um valor de propriedade do membro.

Sintaxe

Member_Expression.Properties(Property_Name [, TYPED])

Argumentos

  • Member_Expression
    Uma expressão MDX válida que retorna um membro.

  • Property_Name
    Uma expressão de cadeia de caracteres válida de um nome de propriedade de membro.

Comentários

A função Properties retorna o valor do membro especificado para a propriedade de membro especificada. A propriedade de membro pode ser qualquer uma das propriedades de membro intrínsecas, como NAME, ID, KEY ou CAPTION, ou pode ser uma propriedade de membro definida pelo usuário. Para obter mais informações, consulte Propriedades intrínsecas do membro (MDX) e Propriedades do membro definidas pelo usuário (MDX).

Por padrão, o valor é forçado a ser uma cadeia de caracteres. Se TYPED for especificado, o valor de retorno terá rigidez de tipos.

  • Se o tipo de propriedade for intrínseco, a função retornará o tipo original de membro.

  • Se o tipo de propriedade for definida pelo usuário, o tipo de valor de retorno será igual ao tipo de valor de retorno da função MemberValue.

ObservaçãoObservação

Propriedades ('Key') retornam o mesmo resultado como Key0 com exceção de chaves compostas. Propriedades ('Key') retornarão nulo para chaves compostas. Use a sintaxe Keyx para chaves compostas, conforme o exemplo. Propriedades ('Key0'), Propriedades ('Key1'), Propriedades ('Key2') etc. formam coletivamente a chave composta.

Exemplo

O exemplo a seguir retorna propriedades de membro intrínsecas e definidas pelo usuário, utilizando o argumento TYPED para retornar o valor com rigidez de tipos para a propriedade de membro Dia Nome.

WITH MEMBER Measures.MemberName AS 
   [Date].[Calendar].[July 1, 2003].Properties('Name')
MEMBER Measures.MemberVal AS 
   [Date].[Calendar].[July 1, 2003].Properties('Member_Value')
MEMBER Measures.MemberKey AS 
   [Date].[Calendar].[July 1, 2003].Properties('Key')
MEMBER Measures.MemberID AS 
   [Date].[Calendar].[July 1, 2003].Properties('ID')
MEMBER Measures.MemberCaption AS 
   [Date].[Calendar].[July 1, 2003].Properties('Caption')
MEMBER Measures.DayName AS 
   [Date].[Calendar].[July 1, 2003].Properties('Day Name', TYPED)
MEMBER Measures.DayNameTyped AS 
   [Date].[Calendar].[July 1, 2003].Properties('Day Name')
MEMBER Measures.DayofWeek AS 
   [Date].[Calendar].[July 1, 2003].Properties('Day of Week')
MEMBER Measures.DayofMonth AS 
   [Date].[Calendar].[July 1, 2003].Properties('Day of Month')
MEMBER Measures.DayofYear AS 
   [Date].[Calendar].[July 1, 2003].Properties('Day of Year')

SELECT {Measures.MemberName
   , Measures.MemberVal
   , Measures.MemberKey
   , Measures.MemberID
   , Measures.MemberCaption
   , Measures.DayName
   , Measures.DayNameTyped
   , Measures.DayofWeek
   , Measures.DayofMonth
   , Measures.DayofYear
   }  ON 0
FROM [Adventure Works]

O exemplo a seguir mostra o uso da propriedade KEYx.

WITH 
MEMBER Measures.MemberKey AS 
   [Customer].[Customer Geography].[State-Province].&[QLD]&[AU].Properties('Key')
MEMBER Measures.MemberKey0 AS 
   [Customer].[Customer Geography].[State-Province].&[QLD]&[AU].Properties('Key0')
MEMBER Measures.MemberKey1 AS 
   [Customer].[Customer Geography].[State-Province].&[QLD]&[AU].Properties('Key1')
 
SELECT {Measures.MemberKey
   , Measures.MemberKey0
   , Measures.MemberKey1   
   }  ON 0
FROM [Adventure Works]

Consulte também

Referência

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

Conceitos

Usando propriedades do membro (MDX)