StrToMember (MDX)

Multidimensional Expressions (MDX) formatlı bir diziyle belirtilen üyeyi döndürür.

Syntax

  
StrToMember(Member_Name [,CONSTRAINED] )   

Arguments

Member_Name
Doğrudan veya dolaylı olarak bir üyeyi belirten geçerli bir dize ifadesi.

Remarks

StrToMember fonksiyonu, dizi ifadesinde belirtilen üyeyi döndürür. StrToMember fonksiyonu genellikle kullanıcı tanımlı fonksiyonlarla birlikte harici bir fonksiyondan bir üye spesifikasyonunu MDX ifadesine geri döndürmek veya bir MDX sorgusu parametre edildiğinde kullanılır.

  • CONSTRAINED bayrağı kullanıldığında, üye adı doğrudan nitelikli veya niteliksiz bir üye adına çözülebilir olmalıdır. Bu bayrak, belirtilen dizide enjeksiyon saldırı riskini azaltmak için kullanılır. Eğer nitelikli veya niteliksiz bir üye adıyla doğrudan çözülemeyen bir dizi sağlanırsa, şu hata ortaya çıkar: "STRTOMEMBER fonksiyonunda CONSTRAINED bayrağının uyguladığı kısıtlamalar ihlal edildi."

  • CONSTRAINED bayrağı kullanılmadığında, belirtilen üye doğrudan bir üye adına çözümlenebilir veya bir MDX ifadesine çözüm verebilir, bu ifade bir isme çözüm verebilir.

  • Kümeler ve üyeler arasındaki farkları daha iyi anlamak için bkz. Küme İfadeleri Kullanımı ve Üye İfadeleri Kullanımı.

Examples

Aşağıdaki örnek, Bayern üyesi için State-Province öznitelik hiyerarşisindeki Satıcı Satış Miktarı ölçüsünü StrToMember fonksiyonu kullanılarak döndürür. Belirtilen dizi nitelikli üye adını verir.

SELECT {StrToMember ('[Geography].[State-Province].[Bayern]')}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]  
  

Aşağıdaki örnek, Bayern üyesi için StrToMember fonksiyonunu kullanarak Satıcı Satış Miktarı ölçüsünü döndürür. Üye adı dizisi yalnızca niteliksiz bir üye adı sağladığından, sorgu belirtilen üyenin ilk örneğini döndürür; bu da Müşteri boyutundaki Müşteri Coğrafyası hiyerarşisinde yer alır ve Satıcı Satışları ile kesişmez. En iyi uygulamalar, beklenen sonuçları sağlamak için nitelikli ismin belirtilmesini gerektirir.

SELECT {StrToMember ('[Bayern]').Parent}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]  
  

Aşağıdaki örnek, Bayern üyesi için State-Province öznitelik hiyerarşisindeki Satıcı Satış Miktarı ölçüsünü StrToMember fonksiyonu kullanılarak döndürür. Sağlanan üye adı dizisi, nitelikli bir üye adına çözüm sağlar.

SELECT {StrToMember('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]  
  

Aşağıdaki örnek, CONSTRAINED bayrağı nedeniyle bir hata döndürür. Sağlanan üye adı dizisi, nitelikli bir üye adına çözümlenen geçerli bir MDX üye ifadesi içerirken, CONSTRAINED bayrağı üye adı dizesinde nitelikli veya niteliksiz üye isimleri gerektirir.

SELECT StrToMember ('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)  
ON 0  
FROM [Adventure Works]