Properties (MDX)

  • Artikel

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.

Bemerkungen

Die Properties-Funktion gibt den Wert des angegebenen Members für die angegebene Membereigenschaft zurück. Die Membereigenschaft kann eine der systeminternen Membereigenschaften sein, z. B. NAME, ID, KEY oder CAPTION, oder es kann sich um eine benutzerdefinierte Membereigenschaft handeln. Weitere Informationen finden Sie unter Systeminterne Membereigenschaften (MDX) und Benutzerdefinierte Membereigenschaften (MDX).

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

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

  • Wenn der Eigenschaftstyp vom Benutzer definiert ist, entspricht der Typ des Rückgabewerts dem Typ des Rückgabewerts der MemberValue-Funktion .

Hinweis

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]

Das folgende Beispiel zeigt die Verwendung der KEYx-Eigenschaft .

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]

Weitere Informationen

Verwenden von Elementeigenschaften (MDX)
MDX-Funktionsreferenz (MDX)