Properties (MDX)

Mis à jour : 12 décembre 2006

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, telle que NAME, ID, KEY, MEMBER_VALUE ou CAPTION, ou bien 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, à l'exception des 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') et ainsi de suite, forment collectivement la clé composite.

Exemples

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]

Voir aussi

Référence

Guide de référence des fonctions MDX (MDX)

Concepts

Utilisation des propriétés de membre (MDX)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
12 décembre 2006	Contenu modifié : Mise à jour du contenu relatif aux clés composites et à la propriété KEYx. Ajout d'un exemple mis à jour.
17 juillet 2006	Contenu modifié : Mise à jour de la syntaxe et des arguments à des fins d'éclaircissement. Ajout d'exemples mis à jour.