CurrentMember (MDX)
Retourne le membre actuel dans une hiérarchie spécifique au cours d'une itération.
Syntaxe
Hierarchy_Expression.CurrentMember
Arguments
- Hierarchy_Expression
Expression MDX (Multidimensional Expressions) valide qui retourne une hiérarchie.
Notes
Au cours d'une itération effectuée dans un jeu de membres de hiérarchie, le membre manipulé à chaque étape de l'itération est le membre actuel. La fonction CurrentMember retourne ce membre.
Important
Lorsqu'une dimension contient uniquement une hiérarchie visible unique, cette hiérarchie peut être désignée soit par le nom de dimension, soit par le nom de la hiérarchie, puisque le nom de dimension est résolu à son unique hiérarchie visible. Par exemple, Measures.CurrentMember est une expression MDX valide parce qu'elle est résolue à la seule hiérarchie de la dimension de mesures.
Exemples
La requête suivante illustre l'utilisation de Currentmember pour rechercher le membre actuel dans les hiérarchies sur l'axe de secteur, les colonnes et les lignes :
WITH MEMBER MEASURES.CURRENTDATE AS
[Date].[Calendar].CURRENTMEMBER.NAME
MEMBER MEASURES.CURRENTPRODUCT AS
[Product].[Product Categories].CURRENTMEMBER.NAME
MEMBER MEASURES.CURRENTMEASURE AS
MEASURES.CURRENTMEMBER.NAME
MEMBER MEASURES.CURRENTCUSTOMER AS
[Customer].[Customer Geography].CURRENTMEMBER.NAME
SELECT
[Product].[Product Categories].[Category].MEMBERS
*
{MEASURES.CURRENTDATE, MEASURES.CURRENTPRODUCT,MEASURES.CURRENTMEASURE, MEASURES.CURRENTCUSTOMER}
ON 0,
[Date].[Calendar].MEMBERS
ON 1
FROM [Adventure Works]
WHERE([Customer].[Customer Geography].[Country].&[Australia])
Le membre actuel change sur une hiérarchie utilisée sur un axe dans une requête. Par conséquent, le membre actuel sur les autres hiérarchies sur la même dimension qui ne sont pas utilisées sur un axe peut également changer ; ce comportement est appelé 'auto-existe', vous trouverez des informations supplémentaires dans Concepts clés dans MDX (MDX). Par exemple, la requête suivante illustre comment le membre actuel sur la hiérarchie Année civile de la dimension Date change avec le membre actuel sur la hiérarchie Calendrier, lorsque celle-ci est affichée sur l'axe des lignes :
WITH MEMBER MEASURES.CURRENTYEAR AS
[Date].[Calendar Year].CURRENTMEMBER.NAME
SELECT
{MEASURES.CURRENTYEAR}
ON 0,
[Date].[Calendar].MEMBERS
ON 1
FROM [Adventure Works]
CurrentMember joue un rôle essentiel pour effectuer des calculs prenant en compte le contexte de la requête dans laquelle ils sont utilisés. Cet exemple retourne, à partir du cube Adventure Works, la quantité commandée de chaque produit et le pourcentage des quantités commandées par catégorie et par modèle. La fonction CurrentMember identifie le produit dont la quantité commandée doit être utilisée lors du calcul.
WITH
MEMBER [Measures].[Order Percent by Category] AS
CoalesceEmpty
(
([Product].[Product Categories].CurrentMember,
Measures.[Order Quantity]) /
(
Ancestor
( [Product].[Product Categories].CurrentMember,
[Product].[Product Categories].[Category]
), Measures.[Order Quantity]
), 0
), FORMAT_STRING='Percent'
SELECT
{Measures.[Order Quantity],
[Measures].[Order Percent by Category]} ON COLUMNS,
{[Product].[Product].Members} ON ROWS
FROM [Adventure Works]
WHERE {[Date].[Calendar Year].[Calendar Year].&[2003]}