Funções Concat e Concatenate

Artigo
10/16/2024

Aplica-se a: Colunas Dataverse de fórmula de aplicativos de tela Fluxos de área de trabalho CLI de aplicativos Power Pages Power Platform orientados por modelo

Concatena cadeias individuais de texto e cadeias em tabelas.

Descrição

A função Concatenate concatena uma mistura de cadeias individuais e uma tabela de coluna única de cadeias. Quando utiliza esta função com cadeias individuais, é equivalente a utilizar o operador&.

A função Concat concatena o resultado de uma fórmula aplicado a todos os registos de uma tabela, o que resulta numa cadeia única. Utilize esta função para resumir as cadeias de uma tabela, tal como a função Sum o faz para os números.

Os atuais campos do registo em processamento estão disponíveis na fórmula. Utilize o operador ThisRecord ou simplesmente campos de referência pelo nome, como com qualquer outro valor. O operador As também pode ser usado para nomear o registo que está a ser processado, o que pode ajudar a tornar a sua fórmula mais fácil de compreender e tornar os registos aninhados acessíveis. Para mais informações, consulte os exemplos abaixo e trabalhar com o âmbito de registo.

Utilize a função Split ou a função MatchAll para dividir uma cadeia numa tabela de subcadeias.

Sintaxe

Concat ( tabela, fórmula, separador)

Tabela - Obrigatório. Tabela a ser utilizada.
Fórmula - Obrigatório. Fórmula a aplicar aos registos da tabela.
Separador - Opcional. Um valor de texto a inserir entre linhas concatenadas da tabela.

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

strings - obrigatório. Combinação de cadeias individuais ou uma tabela de coluna única de cadeias.

Exemplos

Os exemplos nesta secção utilizam estas variáveis globais:

Nome = "Jane"
Sobrenome = "Doe"
Produtos =

Para criar estas variáveis globais numa aplicação, introduza um controlo Button e defina a respetiva propriedade OnSelect com 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 (ao clicar nele enquanto mantém premida a tecla Alt).

Função Concatenate e o operador &

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

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

Concatene com uma tabela de coluna única

Para este exemplo, adicione um controlo Gallery vertical em branco, defina a respetiva propriedade Items como a fórmula na tabela seguinte e, em seguida, adicione uma etiqueta no modelo de galeria.

Fórmula	Descrição	Resultado
Concatenar( "Nome: ", Products.Name, ", Tipo: ", Products.Type )	Para cada registo na tabela Products, concatena a cadeia de caracteres "Name: ", o nome do produto, a cadeia de caracteres ", Type: " e o tipo de produto.	Uma tabela de coluna única com uma coluna `Value` que contém 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 uma etiqueta como uma fórmula a partir da primeira coluna da tabela seguinte.

Fórmula	Descrição	Resultado
Concat( Produtos, Nome, ", " )	Avalia a expressão Name para cada registo de Produtos e concatena os resultados em conjunto numa única cadeia de texto separada por ", ".	""Violino", "Violoncelo", "Trompete""
Concat( Produtos, "'" & Name & "'", ", " )	Avalia a expressão "'" & Name & "'" para cada registo de Produtos e concatena os resultados em conjunto numa única cadeia de texto separada por ", ".	""Violino", "Violoncelo", "Trompete""
Concat( Filter( Products, Type = "String" ), Name, ", " )	Avalia a fórmula Name para cada registo de Produtos que satisfaz o filtro Type = "String" e concatena os resultados numa única cadeia de texto separada por ", ".	"Violino, Violoncelo"

Split e MatchAll

Se utilizou Concat com um separador, pode inverter a operação ao utilizar a função Split.

Para estes exemplos, adicione uma galeria vertical em branco, defina a respetiva propriedade Items como uma fórmula na tabela seguinte e, em seguida, adicione uma etiqueta no modelo de galeria.

Fórmula	Descrição	Resultado
Split( Concat( Produtos, Nome, ", " ), ", " )	Divide a cadeia de texto com o separador ", ".	Uma tabela de coluna única com uma coluna `Value` contendo os seguintes valores: "Violino", "Violoncelo", "Trompete"

Partilhar via