Funções Concat e Concatenate

  • Artigo

Aplica-se a: Aplicativos de tela Colunas de fórmula do Dataverse Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI

Concatena cadeias de texto individuais e cadeias de caracteres em tabelas.

Descrição

A função Concatenate concatena uma mistura de cadeias de caracteres individuais e uma tabela de coluna única de cadeias de caracteres. Quando você usa essa função com cadeias de caracteres individuais, isso é equivalente a usar o operador&.

A função Concat concatena o resultado de uma fórmula aplicada em todos os registros de uma tabela, resultando em uma única cadeia de caracteres. Use essa função para resumir as cadeias de caracteres de uma tabela, assim como a função Sum faz com números.

Os campos do registro que está sendo processado no momento estão disponíveis na fórmula. Use o operador ThisRecord ou simplesmente referencie os campos por nome como faria com qualquer outro valor. O operador Astambém pode ser usado para nomear o registro que está sendo processado, o que pode ajudar a tornar sua fórmula mais fácil de entender e tornar os registros aninhados acessíveis. Para obter mais informações, veja os exemplos abaixo e consulte trabalhando com escopo de registros.

Use a função Split ou MatchAll para dividir uma cadeia de caracteres em uma tabela de subcadeias.

Sintaxe

Concat( Tabela, Fórmula, Separador)

  • Table - obrigatório. Tabela na qual operar.
  • Formula - obrigatório. Fórmula a ser aplicada a todos os registros da tabela.
  • Separador - opcional. Um valor de texto a ser inserido entre linhas concatenadas da tabela.

Concatenate( String1 [, String2, ...] )

  • String(s) - obrigatório. Mistura de cadeias de caracteres individuais ou de uma tabela de coluna única de cadeias de caracteres.

Exemplos

Os exemplos nesta seção usam estas variáveis globais:

  • FirstName = "Clara"
  • LastName = "Barbosa"
  • Produtos = Tabela com duas colunas e quatro linhas.

Para criar essas variáveis globais em um aplicativo, insira um controle Button e defina sua propriedade OnSelect para esta fórmula:

Set( FirstName, "Jane" ); Set( LastName, "Doe" );
Set( Products,
    Table(
        { Name: "Violin", Type: "String" },
        { Name: "Cello", Type: "String" },
        { Name: "Trumpet", Type: "Wind" }
    )
)

Selecione o botão (clicando nele mantendo a tecla Alt pressionada).

Função Concatenate e o operador &

Para estes exemplos, defina a propriedade Text de um controle Label para uma fórmula da primeira coluna da tabela seguinte.

Fórmula Descrição Resultado
Concatenate( LastName, ", ", FirstName ) Concatena o valor em LastName, a cadeia de caracteres ", " (uma vírgula seguida de um espaço) e o valor em FirstName. "Doe, Jane"
LastName & ", " & FirstName Igual ao exemplo anterior, exceto usando o operador &, em vez da função. "Doe, Jane"
Concatenate( FirstName, " ", LastName ) Concatena o valor em FirstName, a cadeia de caracteres " " (um espaço) e o valor em LastName. "Jane Doe"
FirstName & " " & LastName Igual ao exemplo anterior, usando o operador &, em vez da função. "Jane Doe"

Concatenar com uma tabela de coluna única

Para este exemplo, adicione um controle Gallery vertical em branco, defina sua propriedade Items para a fórmula na tabela a seguir e adicione um rótulo ao modelo da galeria.

Fórmula Descrição Resultado
Concatenate( "Name: ", Products.Name, ", Type: ", Products.Type ) Para cada registro na tabela Products, concatene a cadeia de caracteres "Name: ", o nome do produto, a cadeia de caracteres ", Type: " e o tipo do produto. Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Nome: Violino, Tipo: Corda", "Nome: "Violoncelo, Tipo: Corda", "Nome: Trompete, Tipo: Sopro"

Função Concat

Para estes exemplos, defina a propriedade Text de um rótulo para uma fórmula da primeira coluna da tabela seguinte.

Fórmula Description Result
Concat( Products, Name, ", " ) Avalia a expressão Name para cada registro de Products e concatena os resultados juntos em uma única cadeia de caracteres de texto separada por ", ". "'Violino', 'Violoncelo', 'Trompete'"
Concat( Products, "'" & Name & "'", ", " ) Avalia a expressão "'" & Name & "'" para cada registro de Products e concatena os resultados juntos em uma única cadeia de caracteres de texto separada por ", ". "'Violino', 'Violoncelo', 'Trompete'"
Concat( Filter( Products, Type = "String" ), Name, ", " ) Avalia a fórmula Name para cada registro de Products que satisfaça o filtro Type = "String" e concatena os resultados em uma única cadeia de caracteres de texto separada por ", ". "Violino, Violoncelo"

Split e MatchAll

Se tiver usado Concat com um separador, você poderá reverter a operação usando a função Split.

Para estes exemplos, adicione uma galeria vertical em branco, defina sua propriedade Items para uma fórmula na tabela a seguir e adicione um rótulo ao modelo da galeria.

Fórmula Description Result
Split( Concat( Products, Name, ", " ), ", " ) Divide a cadeia de caracteres de texto com o separador ", ". Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Violino", "Violoncelo", "Trompete"