Partilhar via


CONCATENATEX

Aplica-se a:Colunacalculada Tabelacalculada MedidaCálculo visual

Concatena o resultado de uma expressão avaliada para cada linha de uma tabela.

Sintaxe

CONCATENATEX(<table>, <expression>[, <delimiter> [, <orderBy_expression> [, <order>]]...])  

Parâmetros

Termo Definição
tabela A tabela que contém as linhas para as quais a expressão será avaliada.
expressão A expressão a ser avaliada para cada linha da tabela.
delimitador (Opcional) Um separador para usar durante a concatenação.
orderBy_expression (Opcional) Qualquer expressão DAX em que o valor do resultado é usado para classificar os valores concatenados na cadeia de caracteres de saída. É avaliado para cada linha da tabela.
ordem (Opcional) Um valor que especifica como classificar orderBy_expression valores, ascendentes ou decrescentes.

O parâmetro de ordem opcional aceita os seguintes valores:

Value Valores alternativos Description
0 (zero) FALSO, DESC Classifica em ordem decrescente de valores de orderBy_expression. Este é o valor padrão quando o parâmetro order é omitido.
1 VERDADEIRO, ASC Classifica em ordem crescente de valores de orderBy_expression.

Valor devolvido

Uma cadeia de caracteres concatenada.

Observações

  • Esta função toma como primeiro argumento uma tabela ou uma expressão que retorna uma tabela. O segundo argumento é uma coluna que contém os valores que você deseja concatenar ou uma expressão que retorna um valor.

  • Os valores concatenados não são necessariamente classificados em qualquer ordem específica, a menos que orderBy_expression seja especificado.

  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplo

Tabela de funcionários

FirstName LastName
Alan Cervejeiro
Manuel Blythe

A seguinte fórmula:

= CONCATENATEX(Employees, [FirstName] & " " & [LastName], ",")  

Devoluções:
"Alan Brewer, Michael Blythe"