StrToSet (MDX)

更新： 2006 年 7 月 17 日

傳回由多維度運算式 (MDX) 指定的集合 –格式化字串。

語法

StrToSet(Set_Specification [,CONSTRAINED] )

StrToSet 函數會傳回指定的集合。StrToSet 函數一般會搭配使用者自訂函數使用，將來自外部函數的集合規格傳回至 MDX 陳述式。

使用 CONSTRAINED 旗標時，集合規格必須包含限定或未限定成員名稱，或一組包含大括號 {} 所含括之限定或未限定成員名稱的 Tuple。這個旗標用於降低遭到由指定字串發動資料隱碼攻擊的風險。如果所提供的字串不能直接解析成限定或未限定成員名稱，會出現下列錯誤：「違反了 STRTOSET 函數中 CONSTRAINED 旗標所加諸的限制。」
沒有使用 CONSTRAINED 旗標時，指定的集合規格會解析成傳回集合的有效多維度運算式 (MDX) 運算式。

下列範例會藉由使用 StrToSet 函數，來傳回 State-Province 屬性階層的成員集合。集合規格提供有效 MDX 集合運算式。

SELECT StrToSet ('[Geography].[State-Province].Members')
ON 0
FROM [Adventure Works]

下列範例傳回因為 CONSTRAINED 旗標而發生的錯誤。雖然集合規格提供有效 MDX 集合運算式，但 CONSTRAINED 旗標需要集合規格中的限定或未限定成員名稱。

SELECT StrToSet ('[Geography].[State-Province].Members', CONSTRAINED)
ON 0
FROM [Adventure Works]

下列範例會傳回德國和加拿大兩個國家 (地區) 的 Reseller Sales Amount 量值。指定之字串中所提供的集合規格包含 CONSTRAINED 旗標所需的限定成員名稱。

SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)
ON 0
FROM [Adventure Works]

版本	歷程記錄
2006 年 7 月 17 日	變更的內容：更新了語法及引數，以便更加清楚地表示。新增更新的範例。