Properties (MDX)
メンバー プロパティ値を含む文字列または厳密に型指定された値を返します。
構文
Member_Expression.Properties(Property_Name [, TYPED])
引数
Member_Expression
メンバーを 1 つ返す有効な多次元式 (MDX) 式です。Property_Name
メンバー プロパティの名前を表す有効な文字列式です。
説明
Properties 関数は、指定されたメンバー プロパティに対応する指定されたメンバーの値を返します。 メンバー プロパティには、NAME、ID、KEY、CAPTION などの固有メンバー プロパティを任意に指定できます。また、ユーザー定義のメンバー プロパティを指定することもできます。 詳細については、「固有メンバー プロパティ (MDX)」および「ユーザー定義メンバー プロパティ (MDX)」を参照してください。
既定では、強制的に文字列型の値が返されます。 TYPED を指定すると、戻り値は厳密に型指定されます。
プロパティの型が組み込み型の場合、この関数はメンバーの元の型を返します。
プロパティの型がユーザー定義型の場合、戻り値の型は、MemberValue 関数の戻り値の型と同じになります。
注意
Key プロパティは、複合キーを除いて Key0 と同じ結果を返します。Key プロパティは、複合キーに関しては NULL を返します。例に示すように、複合キーには Keyx 構文を使用します。Key0 プロパティ、Key1 プロパティ、Key2 プロパティなどは、全体として複合キーを形成します。
例
次の例では、固有メンバー プロパティとユーザー定義メンバー プロパティを返しています。Day Name メンバー プロパティについては TYPED 引数を使用して、戻り値の型を厳密に指定しています。
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]
次の例は、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]