NAMEOF

Dotyczy:kolumna obliczeniowatabela obliczeniowaMiarawizualizacji

Zwraca nazwę tabeli, kolumny, miary lub kalendarza jako ciąg tekstowy. Parametry opcjonalne kontrolują, który składnik nazwy jest zwracany, oraz sposób ucieczki wyniku.

Składnia

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

Parametry

Termin	Definition
object	Tabela, kolumna, miara lub kalendarz, którego nazwa ma zostać pobrana.
component	(Opcjonalnie) Wyliczenie określające, która część kwalifikowanej nazwy ma być zwracana. W przypadku pominięcia wartość domyślna to FULL. Zobacz Wartości składników.
escaped	(Opcjonalnie) Wyliczenie określające sposób ucieczki zwracanej nazwy. W przypadku pominięcia wartość domyślna to ESCAPED. Zobacz Wartości ucieczki.

Wartości składników

Parametr component akceptuje następujące wartości:

Wartość	Opis
TABLE	Zwraca nazwę tabeli. Zwraca błąd, jeśli obiekt nie jest skojarzony z tabelą (np. kalendarzem).
COLUMN	Zwraca nazwę kolumny. Zwraca błąd, jeśli obiekt nie jest kolumną.
MEASURE	Zwraca nazwę miary. Zwraca błąd, jeśli obiekt nie jest miarą.
CALENDAR	Zwraca nazwę kalendarza. Zwraca błąd, jeśli obiekt nie jest kalendarzem.
FULL	(Ustawienie domyślne) Zwraca w pełni kwalifikowaną nazwę obiektu.
SELF	Zwraca nazwę samego obiektu: kolumnę lub nazwę miary dla kolumn i miar albo nazwę tabeli/kalendarza dla tabel i kalendarzy.
PARENT	Zwraca nazwę tabeli nadrzędnej dla kolumn i miar. Zwraca błąd tabel i kalendarzy.

Wartości ucieczki

Parametr escaped akceptuje następujące wartości:

Wartość	Opis
ESCAPED	(Ustawienie domyślne) Zwraca nazwę z pełnym DAX ucieczką: nazwy tabel opakowane w pojedynczy cudzysłów, kolumny i nazwy miar opakowane w nawiasy kwadratowe.
UNESCAPED	Zwraca nieprzetworzone nazwy bez ograniczników ani znaków ucieczki. Zwraca błąd dla w pełni kwalifikowanych nazw, które zawierają zarówno składnik nadrzędny, jak i podrzędny.
MINIMALLYESCAPED	Zwraca nazwę z ucieczką zastosowaną tylko wtedy, gdy nazwa tego wymaga. Nazwy zawierające tylko proste litery, cyfry i podkreślenia są zwracane bez ograniczników. Nazwy zawierające spacje lub znaki specjalne są zwracane z ucieczką.

Wartość zwracana

Ciąg tekstowy o żądanej nazwie sformatowany na podstawie składnika i parametrów ucieczki.

Uwagi

• W przypadku wywołania z tylko argumentem object funkcja NAMEOF zachowuje się tak samo jak w poprzednich wersjach, zwracając w pełni kwalifikowaną, unikniętą nazwę. Ponieważ component wartości domyślne i FULLescaped domyślne ESCAPEDto , zwracane formaty to:
  • W przypadku tabel: 'TableName'.
  • W przypadku kolumn: 'TableName'[ColumnName].
  • Dla miar: 'TableName'[MeasureName].
  • W przypadku kalendarzy: 'CalendarName'.
  • W przypadku kolumn odmiany: 'TableName'[ColumnName].[VariationName].
• Zmienne i wyrażenia dynamiczne nie są obsługiwane jako argumenty funkcji NAMEOF.
• Ta funkcja nie jest obsługiwana w trybie DirectQuery w przypadku użycia w kolumnach obliczeniowych lub regułach zabezpieczeń na poziomie wiersza.

Zachowanie składnika według typu danych wejściowych

W poniższej tabeli przedstawiono wynik każdej component wartości dla różnych typów danych wejściowych przy użyciu trybu domyślnego ESCAPED . "Błąd" wskazuje, że kombinacja zwraca błąd.

Typ danych wejściowych	TABLE	COLUMN	MEASURE	CALENDAR	FULL	SELF	PARENT
Kolumna- Sales[Sales Amount]	'Sales'	[Sales Amount]	Błąd	Błąd	'Sales'[Sales Amount]	[Sales Amount]	'Sales'
Tabeli- Sales	'Sales'	Błąd	Błąd	Błąd	'Sales'	'Sales'	Błąd
Miara- Sales[m1]	'Sales'	Błąd	[m1]	Błąd	'Sales'[m1]	[m1]	'Sales'
Kalendarz- myCalendar	Błąd	Błąd	Błąd	'myCalendar'	'myCalendar'	'myCalendar'	Błąd

Zachowanie ucieczki

Parametr escaped określa sposób formatowania nazwy wygenerowanej component przez krok. W poniższej tabeli użyto w pełni unikniętej nazwy jako odwołania i przedstawiono dane wyjściowe dla każdej escaped wartości.

W pełni unikniętą nazwę	ESCAPED	UNESCAPED	MINIMALLYESCAPED
'Sales'	'Sales'	Sales	Sales
'Sales'[Sales Amount]	'Sales'[Sales Amount]	Błąd	Sales[Sales Amount]
'Sales'[m1]	'Sales'[m1]	Błąd	Sales[m1]
[Amount]	[Amount]	Amount	Amount
'Sales Region'	'Sales Region'	Sales Region	'Sales Region'
'Sales Region'[Column]	'Sales Region'[Column]	Błąd	'Sales Region'[Column]
[Order Quantity]	[Order Quantity]	Order Quantity	[Order Quantity]

Uwaga / Notatka

UNESCAPED Zwraca błąd w przypadku w pełni kwalifikowanych nazw (nazw, które zawierają zarówno składnik tabeli, jak i kolumny/miary), ponieważ wynik byłby niejednoznaczny bez ograniczników.

Reguły ucieczki znaków specjalnych

Następujące reguły ucieczki mają zastosowanie w DAX ogranicznikach nazw:

• Nazwy tabel (rozdzielane pojedynczym cudzysłowem): Pojedynczy cudzysłów literału (') w nazwie tabeli jest unikany jako dwa cudzysłowy ('').
• Nazwy kolumn i miar (rozdzielane nawiasami): Nawias zamykający literału (]) w kolumnie lub nazwie miary jest zamykany jako ]]. Nawias otwierający ([) nie wymaga ucieczki.

W pełni unikniętą nazwę	ESCAPED	UNESCAPED	MINIMALLYESCAPED
'Ta''''ble' (tabela o ' nazwie)	'Ta''''ble'	Ta''ble	Ta''ble
[colu[]]mn] (kolumna o ] nazwie)	[colu[]]mn]	colu[]mn	[colu[]]mn]

Przykład 1

Następujące DAX zapytanie zwraca w pełni kwalifikowaną nazwę kolumny:

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

Zwraca:

[wartość]
"Sales"[Order Quantity]

Przykład 2

Następujące DAX zapytanie zwraca w pełni kwalifikowaną nazwę miary:

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

EVALUATE
{ NAMEOF ( [Projected Sales] ) }

Zwraca:

[wartość]
"Sales"[Projected Sales]

Przykład 3

Następujące DAX zapytanie używa parametru component , aby wyodrębnić tylko nazwę tabeli z odwołania do kolumny:

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

Zwraca:

[wartość]
"Sprzedaż"

Przykład 4

Następujące DAX zapytanie zwraca niezasłaną nazwę tabeli:

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

Zwraca:

[wartość]
Sales

Przykład 5

Następujące DAX zapytanie używa component parametrów i escaped , aby zwrócić minimalnie unikniętą nazwę tabeli nadrzędnej kolumny:

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

Zwraca:

[wartość]
Sales

Treści powiązane

• Funkcje informacyjne