回傳由多維表達(MDX)格式字串所指定的集合。
Syntax
StrToSet(Set_Specification [,CONSTRAINED] )
論點
Set_Specification
一個有效字串表達式,直接或間接指定一個集合。
備註
StrToSet 函式回傳字串表達式中指定的集合。 StrToSet 函式通常與使用者自訂函式一起使用,用以將外部函式的集合規格回傳至 MDX 陳述式,或在 MDX 查詢參數化時使用。
當使用 CONSTRAINED 旗標時,集合規範必須包含合格或不限定的成員名稱,或一組包含合格或未限定成員名稱的元組,並以大括 {}號包圍。 此旗標用來降低透過指定字串引發注入攻擊的風險。 若提供一個字串無法直接解析至合格或不限定成員名稱,則會出現以下錯誤:「STRTOSET 函式中 CONSTRAINED 標誌所施加的限制已被違反。」
當未使用限制標誌時,指定的集合規範可解析為有效的多維表達式(MDX)表達式,回傳集合。
欲更了解集合與成員的差異,請參閱《使用集合表達式》和《使用成員表達式》。
Examples
以下範例使用 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]
以下範例回傳德國與加拿大的經銷商銷售金額指標。 指定字串中提供的集合規範包含符合 CONSTRAINED 標誌要求的合格成員名稱。
SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)
ON 0
FROM [Adventure Works]