Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Mengembalikan anggota yang ditentukan oleh string yang diformat Multidimensional Expressions (MDX).
Syntax
StrToMember(Member_Name [,CONSTRAINED] )
Arguments
Member_Name
Ekspresi string valid yang menentukan, secara langsung atau tidak langsung, sebuah anggota.
Remarks
Fungsi StrToMember mengembalikan anggota yang ditentukan dalam ekspresi string. Fungsi StrToMember biasanya digunakan dengan fungsi yang ditentukan pengguna untuk mengembalikan spesifikasi anggota dari fungsi eksternal kembali ke pernyataan MDX, atau ketika kueri MDX diparameterisasi.
Ketika flag CONSTRAINED digunakan, nama anggota harus langsung dapat diubah menjadi nama anggota yang memenuhi syarat atau tidak memenuhi syarat. Flag ini digunakan untuk mengurangi risiko serangan injeksi melalui string yang ditentukan. Jika string disediakan yang tidak dapat langsung diselesaikan ke nama anggota yang memenuhi syarat atau tidak memenuhi syarat, muncul kesalahan berikut: "Pembatasan yang diberlakukan oleh flag CONSTRAINED dalam fungsi STRTOMEMBER telah dilanggar."
Ketika flag CONSTRAINED tidak digunakan, anggota yang ditentukan dapat langsung menyelesaikan ke nama anggota atau dapat menyelesaikan ke ekspresi MDX yang beralih ke nama.
Untuk lebih memahami perbedaan antara himpunan dan anggota, lihat Menggunakan Ekspresi Himpunan dan Menggunakan Ekspresi Anggota.
Examples
Contoh berikut mengembalikan ukuran Jumlah Penjualan Reseller untuk anggota Bayern dalam hierarki atribut State-Province menggunakan fungsi StrToMember . String yang ditentukan memberikan nama anggota yang memenuhi syarat.
SELECT {StrToMember ('[Geography].[State-Province].[Bayern]')}
ON 0,
{[Measures].[Reseller Sales Amount]} ON 1
FROM [Adventure Works]
Contoh berikut mengembalikan ukuran Jumlah Penjualan Reseller untuk anggota Bayern menggunakan fungsi StrToMember . Karena string nama anggota hanya memberikan nama anggota yang tidak memenuhi syarat, kueri mengembalikan instance pertama dari anggota yang ditentukan, yang kebetulan berada dalam hierarki Geografi Pelanggan dalam dimensi Pelanggan, yang tidak berpotongan dengan Penjualan Reseller. Praktik terbaik mengharuskan menentukan nama yang memenuhi syarat untuk memastikan hasil yang diharapkan.
SELECT {StrToMember ('[Bayern]').Parent}
ON 0,
{[Measures].[Reseller Sales Amount]} ON 1
FROM [Adventure Works]
Contoh berikut mengembalikan ukuran Jumlah Penjualan Reseller untuk anggota Bayern dalam hierarki atribut State-Province menggunakan fungsi StrToMember . String nama anggota yang disediakan menyelesaikan ke nama anggota yang memenuhi syarat.
SELECT {StrToMember('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)}
ON 0,
{[Measures].[Reseller Sales Amount]} ON 1
FROM [Adventure Works]
Contoh berikut mengembalikan kesalahan akibat flag CONSTRAINED. Meskipun string nama anggota yang disediakan berisi ekspresi anggota MDX yang valid yang diselesaikan menjadi nama anggota yang memenuhi syarat, flag CONSTRAINED memerlukan nama anggota yang memenuhi syarat atau tidak memenuhi syarat dalam string nama anggota.
SELECT StrToMember ('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)
ON 0
FROM [Adventure Works]