Compartilhar via


CONCATENATEX

Aplica-se a:Coluna calculadaTabela calculadaMedidaCá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 a ser usado durante a concatenação.
orderBy_expression (Opcional) Qualquer expressão DAX em que o valor de resultado é usado para classificar os valores concatenados na cadeia de caracteres de saída. A avaliação é realizada para cada linha da tabela.
ordem (Opcional) Um valor que especifica como classificar valores orderBy_expression em ordem crescente ou decrescente.

O parâmetro opcional order aceitará os seguintes valores:

Valor Valores alternativos Descrição
0 (zero) FALSO, DESC Classifica em ordem decrescente de valores de orderBy_expression. É o valor padrão quando o parâmetro order é omitido.
1 TRUE, ASC Classifica em ordem decrescente de valores de orderBy_expression.

Valor retornado

Uma cadeia de caracteres concatenada.

Comentários

  • Essa função usa como seu 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 nenhuma ordem específica, a menos que orderBy_expression seja especificado.

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Exemplo

Tabela Funcionários

FirstName LastName
Alan Brewer
Michael Blythe

A seguinte fórmula:

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

Retorna:
"Alan Brewer, Michael Blythe"