Del via

NAVN PÅ

gjelder:beregnet kolonneberegnet tabellmålevisualobjektberegning

Returnerer navnet på en tabell, kolonne, mål eller kalender som en tekststreng. Valgfrie parametere kontrollerer hvilken komponent i navnet som returneres, og hvordan resultatet slippes ut.

Syntaks

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

Parametere

Begrep Definisjon
object Tabellen, kolonnen, målet eller kalenderen med navnet du vil hente.
component (Valgfritt) En opplisting som angir hvilken del av det kvalifiserte navnet som skal returneres. Hvis utelatt, brukes standarder til FULL. Se komponentverdier.
escaped (Valgfritt) En opplisting som angir hvordan det returnerte navnet er rømt. Hvis utelatt, brukes standarder til ESCAPED. Se Escaped-verdier.

Komponentverdier

Parameteren component godtar følgende verdier:

Verdi Beskrivelse
TABLE Returnerer tabellnavnet. Returnerer en feil hvis objektet ikke er knyttet til en tabell (for eksempel en kalender).
COLUMN Returnerer kolonnenavnet. Returnerer en feil hvis objektet ikke er en kolonne.
MEASURE Returnerer målnavnet. Returnerer en feil hvis objektet ikke er et mål.
CALENDAR Returnerer kalendernavnet. Returnerer en feil hvis objektet ikke er en kalender.
FULL (Standard) Returnerer det fullstendige navnet på objektet.
SELF Returnerer navnet på selve objektet: kolonnen eller målnavnet for kolonner og mål, eller tabell-/kalendernavnet for tabeller og kalendere.
PARENT Returnerer det overordnede tabellnavnet for kolonner og mål. Returnerer en feil for tabeller og kalendere.

Rømte verdier

Parameteren escaped godtar følgende verdier:

Verdi Beskrivelse
ESCAPED (Standard) Returnerer navnet med fullstendig DAX flukt: tabellnavn innpakket i enkle anførselstegn, kolonne- og målnavn som er pakket inn i hakeparenteser.
UNESCAPED Returnerer rånavnet uten skilletegn eller escape-tegn. Returnerer en feil for fullstendige navn som inneholder både en overordnet og underordnet komponent.
MINIMALLYESCAPED Returnerer navnet med escaping brukt bare når navnet krever det. Navn som bare inneholder enkle bokstaver, sifre og understrekingstegn, returneres uten skilletegn. Navn som inneholder mellomrom eller spesialtegn, returneres med rømmer.

Returverdi

En tekststreng med det forespurte navnet, formatert basert på komponenten og de rømte parameterne.

Merknader

  • Når det kalles med bare object argumentet, oppfører NAMEOF seg på samme måte som i tidligere versjoner, og returnerer et fullstendig kvalifisert, rømt navn. Siden component standarder til FULL og escaped standarder er ESCAPED, er returformatene:
    • For tabeller: 'TableName'.
    • For kolonner: 'TableName'[ColumnName].
    • For mål: 'TableName'[MeasureName].
    • For kalendere: 'CalendarName'.
    • For variasjonskolonner: 'TableName'[ColumnName].[VariationName].
  • Variabler og dynamiske uttrykk støttes ikke som argumenter for NAMEOF.
  • Denne funksjonen støttes ikke for bruk i DirectQuery-modus når den brukes i beregnede kolonner eller regler for sikkerhet på radnivå (RLS).

Komponentvirkemåte etter inndatatype

Tabellen nedenfor viser resultatet av hver component verdi for forskjellige inndatatyper, ved hjelp av standardmodus ESCAPED . "Feil" angir at kombinasjonen returnerer en feil.

Inndatatype TABLE COLUMN MEASURE CALENDAR FULL SELF PARENT
Kolonnen- Sales[Sales Amount] 'Sales' [Sales Amount] Feil Feil 'Sales'[Sales Amount] [Sales Amount] 'Sales'
Tabellen- Sales 'Sales' Feil Feil Feil 'Sales' 'Sales' Feil
Måle- Sales[m1] 'Sales' Feil [m1] Feil 'Sales'[m1] [m1] 'Sales'
Kalender- myCalendar Feil Feil Feil 'myCalendar' 'myCalendar' 'myCalendar' Feil

Rømt virkemåte

Parameteren escaped styrer hvordan navnet som produseres av component trinnet, er formatert. Tabellen nedenfor bruker det fullstendig rømte navnet som en referanse, og viser utdataene for hver escaped verdi.

Fullstendig rømt navn ESCAPED UNESCAPED MINIMALLYESCAPED
'Sales' 'Sales' Sales Sales
'Sales'[Sales Amount] 'Sales'[Sales Amount] Feil Sales[Sales Amount]
'Sales'[m1] 'Sales'[m1] Feil Sales[m1]
[Amount] [Amount] Amount Amount
'Sales Region' 'Sales Region' Sales Region 'Sales Region'
'Sales Region'[Column] 'Sales Region'[Column] Feil 'Sales Region'[Column]
[Order Quantity] [Order Quantity] Order Quantity [Order Quantity]

Bemerkning

UNESCAPED returnerer en feil for fullstendige navn (navn som inkluderer både en tabell- og kolonne/målkomponent), fordi resultatet ville vært tvetydig uten skilletegn.

Regler for spesialtegn som rømmer

Følgende regler for rømmer gjelder i DAX navneskilletegn:

  • Tabellnavn (enkeltsitatdelt): Et litteralt enkelt anførselstegn (') i et tabellnavn er escaped som to enkle anførselstegn ('').
  • Kolonne- og målnavn (hakeparentesdelt): En litteral høyre hakeparentes (]) i en kolonne eller et målnavn unnslippes som ]]. En venstre hakeparentes ([) krever ikke at du slipper ut.
Fullstendig rømt navn ESCAPED UNESCAPED MINIMALLYESCAPED
'Ta''''ble' (tabell med ' navnet) 'Ta''''ble' Ta''ble Ta''ble
[colu[]]mn] (kolonne med ] navnet) [colu[]]mn] colu[]mn [colu[]]mn]

Eksempel 1

Følgende DAX spørring returnerer det fullstendige navnet på en kolonne:

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

Returnerer:

[Verdi]
'Salg'[Ordreantall]

Eksempel 2

Følgende DAX spørring returnerer det fullstendige navnet på et mål:

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

EVALUATE
{ NAMEOF ( [Projected Sales] ) }

Returnerer:

[Verdi]
'Salg'[Forventet salg]

Eksempel 3

Følgende DAX spørring bruker parameteren component til å trekke ut bare tabellnavnet fra en kolonnereferanse:

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

Returnerer:

[Verdi]
'Salg'

Eksempel 4

Følgende DAX spørring returnerer et ulandskapt tabellnavn:

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

Returnerer:

[Verdi]
Sales

Eksempel 5

Følgende DAX spørring bruker component og escaped parameterne til å returnere det minimalt rømte overordnede tabellnavnet for en kolonne:

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

Returnerer:

[Verdi]
Sales

Relatert innhold

  • Last updated on