• Artikel

Properties (MDX)

Gibt eine Zeichenfolge oder einen stark typisierten Wert zurück, der den Wert einer Elementeigenschaft enthält.

Syntax

Member_Expression.Properties(Property_Name [, TYPED])

Argumente

  • Member_Expression
    Ein gültiger MDX-Ausdruck (Multidimensional Expressions), der ein Element zurückgibt.

  • Property_Name
    Ein gültiger Zeichenfolgenausdruck, der den Namen einer Elementeigenschaft enthält.

Hinweise

Die Properties-Funktion gibt den Wert des angegebenen Elements für die angegebene Elementeigenschaft zurück. Die Elementeigenschaft kann entweder eine beliebige systeminterne Elementeigenschaft (beispielsweise NAME, ID, KEY oder CAPTION) sein. Sie kann aber auch eine benutzerdefinierte Elementeigenschaft sein. Weitere Informationen finden Sie unter Integrierte Elementeigenschaften (MDX) und Benutzerdefinierte Elementeigenschaften (MDX).

Standardmäßig muss der Wert zwingend eine Zeichenfolge sein. Wenn TYPED angegeben wird, ist der Rückgabewert stark typisiert.

  • Bei einer systeminternen Eigenschaft gibt die Funktion den ursprünglichen Typ des Elements zurück.

  • Bei einem benutzerdefinierten Eigenschaftentyp entspricht der Typ des Rückgabewerts dem Typ des Rückgabewerts der MemberValue-Funktion.

HinweisHinweis

Properties ('Key') gibt das gleiche Ergebnis wie Key0 zurück, außer für zusammengesetzte Schlüssel. Properties ('Key') gibt für zusammengesetzte Schlüssel den Wert NULL zurück. Verwenden Sie die Keyx-Syntax für zusammengesetzte Schlüssel, wie im Beispiel veranschaulicht. Properties ('Key0'), Properties('Key1'), Properties('Key2') usw. bilden zusammen den zusammengesetzten Schlüssel.

Beispiel

Im folgenden Beispiel werden sowohl systemeigene als auch benutzerdefinierte Elementeigenschaften zurückgegeben. Dabei wird das TYPED-Argument verwendet, um den stark typisierten Wert für die Day Name-Elementeigenschaft zurückzugeben.

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]

Im folgenden Beispiel wird die Verwendung der KEYx-Eigenschaft veranschaulicht.

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]