Ler em inglês

Compartilhar via


CONCATENATEX

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

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

Sintaxe

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

Parâmetros

Prazo Definição
table A tabela que contém as linhas para as quais a expressão será avaliada.
expression A expressão a ser avaliada para cada linha de table.
delimiter (Opcional) Um separador a ser usado 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. Ele é avaliado para cada linha de table.
order (Opcional) Um valor que especifica como classificar orderBy_expression valores, crescentes ou decrescentes.

O parâmetro order opcional aceita os seguintes valores:

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

Valor de retorno

Uma cadeia de caracteres concatenada.

Observações

  • 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.

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

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

Exemplo

Tabela Funcionários

FirstName LastName
Alan Cervejeiro
Michael Blythe

A seguinte fórmula:

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

Retorna:
"Alan Brewer, Michael Blythe"