NAVN PÅ

gælder for:beregnet kolonneberegnet tabelberegning af målingvisualisering

Returnerer navnet på en tabel, kolonne, mål eller kalender som en tekststreng. Valgfrie parametre styrer, hvilken komponent af navnet der returneres, og hvordan resultatet undslap.

Syntaks

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

Parametre

Vilkår Definition
object Den tabel, kolonne, måling eller kalender, hvis navn du vil hente.
component (Valgfrit) En optælling, der angiver, hvilken del af det kvalificerede navn der skal returneres. Hvis den udelades, angives som standard til FULL. Se Komponentværdier.
escaped (Valgfrit) En optælling, der angiver, hvordan det returnerede navn er escape. Hvis den udelades, angives som standard til ESCAPED. Se Escape-værdier.

Komponentværdier

Parameteren component accepterer følgende værdier:

Værdi Beskrivelse
TABLE Returnerer tabelnavnet. Returnerer en fejl, hvis objektet ikke er knyttet til en tabel (f.eks. en kalender).
COLUMN Returnerer kolonnenavnet. Returnerer en fejl, hvis objektet ikke er en kolonne.
MEASURE Returnerer målingsnavnet. Returnerer en fejl, hvis objektet ikke er en måling.
CALENDAR Returnerer kalendernavnet. Returnerer en fejl, hvis objektet ikke er en kalender.
FULL (Standard) Returnerer objektets fuldt kvalificerede navn.
SELF Returnerer navnet på selve objektet: kolonne- eller målingsnavnet for kolonner og målinger eller tabel-/kalendernavnet for tabeller og kalendere.
PARENT Returnerer det overordnede tabelnavn for kolonner og målinger. Returnerer en fejl for tabeller og kalendere.

Escape-værdier

Parameteren escaped accepterer følgende værdier:

Værdi Beskrivelse
ESCAPED (Standard) Returnerer navnet med fuld DAX escapeaping: tabelnavne ombrudt i enkelte anførselstegn, kolonne- og målingsnavne ombrudt i kantede parenteser.
UNESCAPED Returnerer det rå navn uden nogen afgrænsere eller escape-tegn. Returnerer en fejl for fuldt kvalificerede navne, der indeholder både en overordnet og en underordnet komponent.
MINIMALLYESCAPED Returnerer navnet, hvor escaping kun anvendes, når navnet kræver det. Navne, der kun indeholder simple bogstaver, cifre og understregningstegn, returneres uden afgrænsere. Navne, der indeholder mellemrum eller specialtegn, returneres med escaping.

Returværdi

En tekststreng med det ønskede navn, formateret på baggrund af komponenten og escape-parametre.

Bemærkninger

  • Når NAMEOF kun object kaldes med argumentet, fungerer det samme som i tidligere versioner og returnerer et fuldt kvalificeret, escape-navn. Da component standard er FULL og escaped er som standard ESCAPED, er returformaterne:
    • For tabeller: 'TableName'.
    • For kolonner: 'TableName'[ColumnName].
    • For målinger: 'TableName'[MeasureName].
    • For kalendere: 'CalendarName'.
    • For variationskolonner: 'TableName'[ColumnName].[VariationName].
  • Variabler og dynamiske udtryk understøttes ikke som argumenter til NAMEOF.
  • Denne funktion understøttes ikke til brug i DirectQuery-tilstand, når den bruges i beregnede kolonner eller RLS-regler (row-level security).

Komponentfunktionsmåde efter inputtype

I følgende tabel vises resultatet af hver component værdi for forskellige inputtyper ved hjælp af standardtilstanden ESCAPED . "Error" angiver, at kombinationen returnerer en fejl.

Inputtype TABLE COLUMN MEASURE CALENDAR FULL SELF PARENT
Kolonne- Sales[Sales Amount] 'Sales' [Sales Amount] Fejl Fejl 'Sales'[Sales Amount] [Sales Amount] 'Sales'
Tabel- Sales 'Sales' Fejl Fejl Fejl 'Sales' 'Sales' Fejl
Foranstaltning- Sales[m1] 'Sales' Fejl [m1] Fejl 'Sales'[m1] [m1] 'Sales'
Kalender- myCalendar Fejl Fejl Fejl 'myCalendar' 'myCalendar' 'myCalendar' Fejl

Escape-funktionsmåde

Parameteren escaped styrer, hvordan det navn, der oprettes af component trinnet, formateres. I følgende tabel bruges det fuldt escape-navn som reference og viser outputtet for hver escaped værdi.

Fuldt escape-navn ESCAPED UNESCAPED MINIMALLYESCAPED
'Sales' 'Sales' Sales Sales
'Sales'[Sales Amount] 'Sales'[Sales Amount] Fejl Sales[Sales Amount]
'Sales'[m1] 'Sales'[m1] Fejl Sales[m1]
[Amount] [Amount] Amount Amount
'Sales Region' 'Sales Region' Sales Region 'Sales Region'
'Sales Region'[Column] 'Sales Region'[Column] Fejl 'Sales Region'[Column]
[Order Quantity] [Order Quantity] Order Quantity [Order Quantity]

Bemærkning

UNESCAPED returnerer en fejl for fuldt kvalificerede navne (navne, der omfatter både en tabel og en kolonne/målingskomponent), fordi resultatet ville være tvetydigt uden afgrænsere.

Regler for escape af specialtegn

Følgende escape-regler gælder i DAX navneafgrænsere:

  • Tabelnavne (afgrænset med et enkelt anførselstegn): Et konstant enkelt anførselstegn (') i et tabelnavn undslap som to enkelte anførselstegn ('').
  • Kolonne- og målingsnavne (parentessepareret): En konstant slutparentes (]) i et kolonne- eller målingsnavn undslap som ]]. En venstreparentes ([) kræver ikke escaping.
Fuldt escape-navn ESCAPED UNESCAPED MINIMALLYESCAPED
'Ta''''ble' (tabel med ' navn) 'Ta''''ble' Ta''ble Ta''ble
[colu[]]mn] (kolonne med ] navnet) [colu[]]mn] colu[]mn [colu[]]mn]

Eksempel 1

Følgende DAX forespørgsel returnerer det fuldt kvalificerede navn på en kolonne:

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

Returnerer:

[Værdi]
'Salg'[Ordreantal]

Eksempel 2

Følgende DAX forespørgsel returnerer det fuldt kvalificerede navn på en måling:

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

EVALUATE
{ NAMEOF ( [Projected Sales] ) }

Returnerer:

[Værdi]
'Salg'[Forventet salg]

Eksempel 3

I følgende DAX forespørgsel bruges component parameteren til kun at udtrække tabelnavnet fra en kolonnereference:

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

Returnerer:

[Værdi]
'Salg'

Eksempel 4

Følgende DAX forespørgsel returnerer et tabelnavn, der ikke er blevet vist:

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

Returnerer:

[Værdi]
Sales

Eksempel 5

Følgende DAX forespørgsel bruger parametrene component og escaped til at returnere det minimalt undslapne overordnede tabelnavn for en kolonne:

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

Returnerer:

[Værdi]
Sales

Relateret indhold

  • Last updated on