• Article

Properties (MDX)

Retourne une chaîne ou une valeur fortement typée, contenant une valeur de propriété de membre.

Syntaxe

Member_Expression.Properties(Property_Name [, TYPED])

Arguments

  • Member_Expression
    Expression MDX (Multidimensional Expressions) valide qui retourne un membre.

  • Property_Name
    Expression de chaîne valide du nom d'une propriété de membre.

Notes

La fonction Properties retourne la valeur du membre spécifié pour la propriété de membre spécifiée. La propriété de membre peut être n'importe quelle propriété de membre intrinsèque, comme NAME, ID, KEY ou CAPTION, ou peut être une propriété de membre définie par l'utilisateur. Pour plus d'informations, consultez Propriétés de membre intrinsèques (MDX) et Propriétés de membre définies par l'utilisateur (MDX).

Par défaut, la valeur est définie comme une chaîne. Si TYPED est spécifié, la valeur de retour est fortement typée.

  • Si le type de propriété est intrinsèque, la fonction retourne le type d'origine du membre.

  • Si le type de propriété est défini par l'utilisateur, le type de la valeur de retour est identique à celui de la valeur de retour de la fonction MemberValue.

[!REMARQUE]

Properties('Key') retourne le même résultat que Key0, sauf en ce qui concerne les clés composites. Properties('Key') retourne la valeur Null pour les clés composites. Utilisez la syntaxe Keyx pour les clés composites comme illustré dans l'exemple suivant. Properties('Key0'), Properties('Key1'), Properties('Key2'), etc., forment collectivement la clé composite.

Exemple

L'exemple ci-dessous retourne à la fois des propriétés de membres intrinsèques et définies par l'utilisateur en se servant de l'argument TYPED pour retourner la valeur fortement typée de la propriété de membre Day Name (Jour).

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]

L'exemple suivant décrit l'utilisation de la propriété 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]