NAMEOF

Si applica a:colonna calcolatatabella calcolata calcolo visivomisura

Restituisce il nome di una tabella, una colonna, una misura o un calendario come stringa di testo. I parametri facoltativi controllano il componente del nome restituito e la modalità di escape del risultato.

Sintassi

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

Parametri

Termine Definition
object Tabella, colonna, misura o calendario il cui nome si desidera recuperare.
component (Facoltativo) Enumerazione che specifica quale parte del nome completo restituire. Se omesso, il valore predefinito è FULL. Vedere Valori dei componenti.
escaped (Facoltativo) Enumerazione che specifica la modalità di escape del nome restituito. Se omesso, il valore predefinito è ESCAPED. Vedere Valori di escape.

Valori dei componenti

Il parametro component accetta i valori seguenti:

Valore Descrizione
TABLE Restituisce il nome della tabella. Restituisce un errore se l'oggetto non è associato a una tabella, ad esempio un calendario.
COLUMN Restituisce il nome della colonna. Restituisce un errore se l'oggetto non è una colonna.
MEASURE Restituisce il nome della misura. Restituisce un errore se l'oggetto non è una misura.
CALENDAR Restituisce il nome del calendario. Restituisce un errore se l'oggetto non è un calendario.
FULL (Impostazione predefinita) Restituisce il nome completo dell'oggetto.
SELF Restituisce il nome dell'oggetto stesso: la colonna o il nome della misura per colonne e misure oppure il nome della tabella/calendario per tabelle e calendari.
PARENT Restituisce il nome della tabella padre per colonne e misure. Restituisce un errore per tabelle e calendari.

Valori preceduti da escape

Il parametro escaped accetta i valori seguenti:

Valore Descrizione
ESCAPED (Impostazione predefinita) Restituisce il nome con escape completo DAX : nomi di tabella racchiusi tra virgolette singole, colonne e nomi di misura racchiusi tra parentesi quadre.
UNESCAPED Restituisce il nome non elaborato senza delimitatori o caratteri di escape. Restituisce un errore per i nomi completi che contengono sia un componente padre che un componente figlio.
MINIMALLYESCAPED Restituisce il nome con escape applicato solo quando il nome lo richiede. I nomi che contengono solo lettere semplici, cifre e caratteri di sottolineatura vengono restituiti senza delimitatori. I nomi che contengono spazi o caratteri speciali vengono restituiti con l'escape.

Valore restituito

Stringa di testo con il nome richiesto, formattata in base al componente e ai parametri di escape.

Osservazioni:

  • Quando viene chiamato solo con l'argomento object , NAMEOF si comporta come nelle versioni precedenti, restituendo un nome di escape completo e completo. Poiché component per FULL impostazione predefinita e escaped è impostato su , i formati restituiti ESCAPEDsono:
    • Per le tabelle: 'TableName'.
    • Per le colonne: 'TableName'[ColumnName].
    • Per le misure: 'TableName'[MeasureName].
    • Per i calendari: 'CalendarName'.
    • Per le colonne di variazione: 'TableName'[ColumnName].[VariationName].
  • Le variabili e le espressioni dinamiche non sono supportate come argomenti per NAMEOF.
  • Questa funzione non è supportata per l'uso in modalità DirectQuery quando viene usata nelle colonne calcolate o nelle regole di sicurezza a livello di riga.

Comportamento del componente per tipo di input

Nella tabella seguente viene illustrato il risultato di ogni component valore per tipi di input diversi, usando la modalità predefinita ESCAPED . "Errore" indica che la combinazione restituisce un errore.

Tipo di input TABLE COLUMN MEASURE CALENDAR FULL SELF PARENT
Colonna- Sales[Sales Amount] 'Sales' [Sales Amount] Error Error 'Sales'[Sales Amount] [Sales Amount] 'Sales'
Tavolo- Sales 'Sales' Error Error Error 'Sales' 'Sales' Error
Misura- Sales[m1] 'Sales' Error [m1] Error 'Sales'[m1] [m1] 'Sales'
Calendario- myCalendar Error Error Error 'myCalendar' 'myCalendar' 'myCalendar' Error

Comportamento di escape

Il escaped parametro controlla la formattazione del component nome prodotto dal passaggio. La tabella seguente usa il nome con escape completo come riferimento e mostra l'output per ogni escaped valore.

Nome con escape completo 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]

Annotazioni

UNESCAPED restituisce un errore per i nomi completi (nomi che includono sia una tabella che un componente di colonna/misura), perché il risultato sarebbe ambiguo senza delimitatori.

Regole di escape dei caratteri speciali

Le regole di escape seguenti si applicano all'interno DAX dei delimitatori dei nomi:

  • Nomi di tabella (delimitati da virgolette singole): Una virgoletta singola letterale (') in un nome di tabella viene preceduta da un carattere di escape come due virgolette singole ('').
  • Nomi di colonna e misura (delimitati da parentesi quadre): Una parentesi di chiusura letterale (]) in una colonna o un nome di misura viene preceduta da un carattere di escape come ]]. Una parentesi aperta ([) non richiede l'escape.
Nome con escape completo ESCAPED UNESCAPED MINIMALLYESCAPED
'Ta''''ble' (tabella con ' in nome) 'Ta''''ble' Ta''ble Ta''ble
[colu[]]mn] (colonna con ] in nome) [colu[]]mn] colu[]mn [colu[]]mn]

Esempio 1

La query seguente DAX restituisce il nome completo di una colonna:

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

Restituisce:

[Valore]
'Sales'[Order Quantity]

Esempio 2

La query seguente DAX restituisce il nome completo di una misura:

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

EVALUATE
{ NAMEOF ( [Projected Sales] ) }

Restituisce:

[Valore]
'Sales'[Projected Sales]

Esempio 3

La query seguente DAX usa il component parametro per estrarre solo il nome della tabella da un riferimento a una colonna:

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

Restituisce:

[Valore]
'Sales'

Esempio 4

La query seguente DAX restituisce un nome di tabella senza caratteri di escape:

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

Restituisce:

[Valore]
Vendite

Esempio 5

La query seguente DAX usa i component parametri e escaped per restituire il nome di tabella padre con carattere di escape minimo di una colonna:

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

Restituisce:

[Valore]
Vendite

Contenuti correlati

  • funzioni informazioni
  • Last updated on