NAMEOF

Şunlar için geçerlidir:Hesaplanan sütunHesaplanan tabloÖlçüGörsel hesaplama

Tablo, sütun, ölçü veya takvimin adını metin dizesi olarak döndürür. İsteğe bağlı parametreler, adın hangi bileşeninin döndürülür ve sonucun nasıl kaçıldığını denetler.

Sözdizimi

NAMEOF ( <object> [, <component> [, <escaped>]] )

Parametreler

Süre Definition
object Adını almak istediğiniz tablo, sütun, ölçü veya takvim.
component (İsteğe bağlı) Nitelenmiş adın hangi bölümünün döndürüleceği belirten bir numaralandırma. Atlanırsa, varsayılan olarak olur FULL. Bkz . Bileşen değerleri.
escaped (İsteğe bağlı) Döndürülen adın nasıl kaçıldığını belirten bir numaralandırma. Atlanırsa, varsayılan olarak olur ESCAPED. Bkz . Kaçış değerleri.

Bileşen değerleri

component parametresi aşağıdaki değerleri kabul eder:

Değer Açıklama
TABLE Tablo adını döndürür. Nesne bir tabloyla (örneğin, takvim) ilişkilendirilmemişse bir hata döndürür.
COLUMN Sütun adını döndürür. Nesne bir sütun değilse hata döndürür.
MEASURE Ölçü adını döndürür. Nesne bir ölçü değilse hata döndürür.
CALENDAR Takvim adını döndürür. Nesne bir takvim değilse hata döndürür.
FULL (Varsayılan) Nesnenin tam adını döndürür.
SELF Nesnenin adını döndürür: sütunlar ve ölçüler için sütun veya ölçü adı ya da tablolar ve takvimler için tablo/takvim adı.
PARENT Sütunlar ve ölçüler için üst tablo adını döndürür. Tablolar ve takvimler için bir hata döndürür.

Kaçış değerleri

escaped parametresi aşağıdaki değerleri kabul eder:

Değer Açıklama
ESCAPED (Varsayılan) Tam DAX kaçış içeren adı döndürür: tek tırnak içine alınmış tablo adları, köşeli ayraç içine alınmış sütun ve ölçü adları.
UNESCAPED Herhangi bir sınırlayıcı veya kaçış karakteri olmadan ham adı döndürür. Hem üst hem de alt bileşen içeren tam adlar için bir hata döndürür.
MINIMALLYESCAPED Kaçışın uygulandığı adı yalnızca ad gerektirdiğinde döndürür. Yalnızca basit harf, rakam ve alt çizgi içeren adlar sınırlayıcı olmadan döndürülür. Boşluk veya özel karakter içeren adlar kaçışla birlikte döndürülür.

Dönüş değeri

bileşene ve kaçış parametrelerine göre biçimlendirilmiş, istenen ada sahip bir metin dizesi.

Açıklamalar

  • YALNıZCA object bağımsız değişkenle çağrıldığında, NAMEOF önceki sürümlerdekiyle aynı şekilde davranır ve tam bir kaçış adı döndürür. component varsayılan değeri FULL ve escaped varsayılanı ESCAPEDolduğundan, dönüş biçimleri şunlardır:
    • Tablolar için: 'TableName'.
    • Sütunlar için: 'TableName'[ColumnName].
    • Ölçüler için: 'TableName'[MeasureName].
    • Takvimler için: 'CalendarName'.
    • Çeşitleme sütunları için: 'TableName'[ColumnName].[VariationName].
  • Değişkenler ve dinamik ifadeler NAMEOF bağımsız değişkeni olarak desteklenmez.
  • Bu işlev, hesaplanan sütunlarda veya satır düzeyi güvenlik (RLS) kurallarında kullanıldığında DirectQuery modunda kullanılmak üzere desteklenmez.

Giriş türüne göre bileşen davranışı

Aşağıdaki tablo, varsayılan ESCAPED modu kullanarak farklı giriş türleri için her component değerin sonucunu gösterir. "Error", birleşimin bir hata döndürdüğünü gösterir.

Giriş türü TABLE COLUMN MEASURE CALENDAR FULL SELF PARENT
Sütun- Sales[Sales Amount] 'Sales' [Sales Amount] Error Error 'Sales'[Sales Amount] [Sales Amount] 'Sales'
Tablo- Sales 'Sales' Error Error Error 'Sales' 'Sales' Error
Ölçü- Sales[m1] 'Sales' Error [m1] Error 'Sales'[m1] [m1] 'Sales'
Takvim- myCalendar Error Error Error 'myCalendar' 'myCalendar' 'myCalendar' Error

Kaçış davranışı

parametresi, escaped adım tarafından oluşturulan adın component nasıl biçimlendirildiğini denetler. Aşağıdaki tabloda, başvuru olarak tam kaçış adı kullanılır ve her escaped değerin çıkışı gösterilir.

Tam kaçış adı ESCAPED UNESCAPED MINIMALLYESCAPED
'Sales' 'Sales' Sales Sales
'Sales'[Sales Amount] 'Sales'[Sales Amount] Error Sales[Sales Amount]
'Sales'[m1] 'Sales'[m1] Error Sales[m1]
[Amount] [Amount] Amount Amount
'Sales Region' 'Sales Region' Sales Region 'Sales Region'
'Sales Region'[Column] 'Sales Region'[Column] Error 'Sales Region'[Column]
[Order Quantity] [Order Quantity] Order Quantity [Order Quantity]

Uyarı

UNESCAPED tam adlar (hem tablo hem de sütun/ölçü bileşeni içeren adlar) için bir hata döndürür çünkü sonuç sınırlayıcılar olmadan belirsiz olur.

Özel karakter kaçış kuralları

Ad sınırlayıcıları içinde DAX aşağıdaki kaçış kuralları geçerlidir:

  • Tablo adları (sınırlandırılmış tek tırnak): Bir tablo adındaki değişmez tek tırnak ('), iki tek tırnak ('') olarak kaçıştır.
  • Sütun ve ölçü adları (köşeli ayraç sınırlandırılmış): Sütun veya ölçü adındaki değişmez değer kapatma köşeli ayracı (]) olarak kaçıştır ]]. Açma köşeli ayracı ([) kaçış gerektirmez.
Tam kaçış adı ESCAPED UNESCAPED MINIMALLYESCAPED
'Ta''''ble' (adı olan ' tablo) 'Ta''''ble' Ta''ble Ta''ble
[colu[]]mn] (adı olan ] sütun) [colu[]]mn] colu[]mn [colu[]]mn]

Örnek 1

Aşağıdaki DAX sorgu bir sütunun tam adını döndürür:

EVALUATE
{ NAMEOF ( 'Sales'[ORDER QUANTITY] ) }

İadeler

[Değer]
'Sales'[Order Quantity]

Örnek 2

Aşağıdaki DAX sorgu bir ölçünün tam adını döndürür:

DEFINE
    MEASURE Sales[Projected Sales] =
        SUM ( 'Sales'[Sales Amount] ) * 1.06

EVALUATE
{ NAMEOF ( [Projected Sales] ) }

İadeler

[Değer]
'Sales'[Projected Sales]

Örnek 3

Aşağıdaki DAX sorgu, sütun başvurusundan yalnızca tablo adını ayıklamak için parametresini kullanır component :

EVALUATE
{ NAMEOF ( 'Sales'[Sales Amount], TABLE ) }

İadeler

[Değer]
'Sales'

Örnek 4

Aşağıdaki DAX sorgu, manzarasız bir tablo adı döndürür:

EVALUATE
{ NAMEOF ( 'Sales', FULL, UNESCAPED ) }

İadeler

[Değer]
Sales

Örnek 5

Aşağıdaki DAX sorgu, bir sütunun component en düşük çıkışlı üst tablo adını döndürmek için ve escaped parametrelerini kullanır:

EVALUATE
{ NAMEOF ( 'Sales'[Sales Amount], PARENT, MINIMALLYESCAPED ) }

İadeler

[Değer]
Sales

İlgili içerik

  • Last updated on