Compartilhar via

Concat e Concatenate funções

Função Aplica-se a
Concat Aplicativos de tela Copilot Studio Desktop flui aplicativos baseados em modelo CLI CLI Dataverse funções Power Pages
Concatenate Aplicativos de tela O Copilot Studio Desktop flui colunas de fórmula do Dataverse para aplicativos controlados por modelos do Power Platform CLI Dataverse functions Power Pages

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

Descrição

A Concatenate função concatena uma combinação 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 Concat função 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)

  • Tabela - Obrigatório. Tabela na qual operar.
  • Fórmula - 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, ...] )

  • Strings - 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:

  • PrimeiroNome = "Jane"
  • Sobrenome = "Doe"
  • 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).

Concatenate função 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"
Sobrenome & ", " & Nome 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"
Primeiro nome e " " e Sobrenome Igual ao exemplo anterior, usando o operador &, em vez da função. "Jane Doe"

Concatenate 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"

Concat Função

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

Fórmula Descrição Resultado
Concat( Produtos, Nome, ", " ) 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( Produtos, "'" & Nome &"'", ", " ) 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 você usou Concat com um separador, poderá reverter a operação usando a função Dividir .

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 Descrição Resultado
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"
  • Last updated on