De functies Concat en Concatenate

Van toepassing op: Canvas-apps Dataverse-formulekolommen Bureaubladstromen Modelgestuurde apps Power Platform CLI

Voegt afzonderlijke tekenreeksen of tekst en tekenreeksen samen in tabellen.

Beschrijving

De functie Concatenate voegt afzonderlijke tekenreeksen en een tabel met één kolom met tekenreeksen samen. Als u deze functie gebruikt met afzonderlijke tekenreeksen, is deze gelijkwaardig aan het gebruik van de operator&.

De functie Concat voegt de resultaten samen van een formule die is toegepast op alle records van een tabel, wat resulteert in een enkele tekenreeks. Gebruik deze functie om een overzicht van de tekenreeksen van een tabel te maken, zoals de functie Sum doet voor getallen.

Velden van de momenteel verwerkte record zijn beschikbaar in de formule. Gebruik de operator ThisRecord of verwijs gewoon met de naam naar velden, zoals u dat ook bij andere waarden zou doen. De operator As kan ook worden gebruikt om een naam te geven aan de record die wordt verwerkt, wat kan helpen uw formule begrijpelijker te maken en geneste records toegankelijk te maken. Meer informatie vindt u in de voorbeelden hieronder en in werken met recordbereik.

Gebruik de functie Split of MatchAll om een tekenreeks te splitsen in een tabel met subtekenreeksen.

Syntaxis

Concat( Tabel, Formule, scheidingsteken)

  • Table: vereist. De tabel waarop de bewerking wordt toegepast.
  • Formula: vereist. De formule om toe te passen op alle records van de tabel.
  • Separator: optioneel. Een tekstwaarde die moet worden ingevoegd tussen aaneengeschakelde rijen van de tabel.

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

  • String(s): vereist. Een combinatie van afzonderlijke tekenreeksen of een tabel met één kolom met tekenreeksen.

Voorbeelden

In de voorbeelden in deze sectie worden deze globale variabelen gebruikt:

  • FirstName = "Jane"
  • LastName = "Doe"
  • PRODUCTEN = Tabel met twee kolommen en vier rijen.

Als u deze globale variabelen in een app wilt maken, voegt u een besturingselement Button in en stelt u de eigenschap OnSelect van dit element in op deze formule:

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

Selecteer de knop (door erop te klikken terwijl u de Alt-toets ingedrukt houdt).

Concatenate-functie en de &-operator

Voor deze voorbeelden stelt u de eigenschap Text van een besturingselement Label in op een formule uit de eerste kolom van de volgende tabel.

Formule Beschrijving Resultaat
Concatenate( LastName, ", ", FirstName ) Voegt de waarde in LastName, de tekenreeks ", " (een komma, gevolgd door een spatie) en de waarde in FirstName samen. "Doe, Jane"
LastName & ", " & FirstName Hetzelfde als het vorige voorbeeld, behalve met de operator & in plaats van de functie. "Doe, Jane"
Concatenate( FirstName, " ", LastName ) Voegt de waarde in FirstName, de tekenreeks " " (één spatie) en de waarde in LastName samen. "Jane Doe"
FirstName & " " & LastName Hetzelfde als het vorige voorbeeld, behalve met de operator & in plaats van de functie. "Jane Doe"

Samenvoegen met een tabel met één kolom

Voor dit voorbeeld voegt u een leeg, verticaal besturingselement van het type Gallery toe. Stel de eigenschap Items ervan in op de formule in de volgende tabel en voeg een label toe aan de galeriesjabloon.

Formule Beschrijving Resultaat
Concatenate( "Name: ", Products.Name, ", Type: ", Products.Type ) Voor elke record in de tabel Products worden de tekenreeks "Name: ", de naam van het product, de tekenreeks ", Type: " en het type product samengevoegd. Een tabel met één kolom met een Value-kolom die de volgende waarden bevat: "Name: Violin, Type: String", "Name: "Cello, Type: String", "Name: Trumpet, Type: Wind"

Functie Concat

Voor deze voorbeelden stelt u de eigenschap Text van een label in op een formule uit de eerste kolom van de volgende tabel.

Formule Omschrijving Result
Concat( Products, Name & ", " ) Evalueert de expressie Name voor elke record van Products en voegt de resultaten samen in één teksttekenreeks gescheiden door ", ". "'Viool', 'Cello', 'Trompet'"
Concat( Products, "'" & Name & "'", ", " ) Evalueert de expressie "'" & Name & "'" voor elke record van Products en voegt de resultaten samen in één teksttekenreeks gescheiden door ", ". "'Viool', 'Cello', 'Trompet'"
Concat( Filter( Products, Type = "String" ), Name, ", " ) Evalueert de formule Name voor elke record van Products die voldoet aan het filter Type = "String" en voegt de resultaten samen in één tekenreeks gescheiden door ", ". "Viool, Cello"

Split en MatchAll

Als u Concat gebruikt met een scheidingsteken, kunt u de bewerking omkeren door de functie Split te gebruiken.

Voor deze voorbeelden voegt u een lege, verticale galerie toe, stelt u de eigenschap Items ervan in op een formule in de volgende tabel en voegt u een label toe aan de galeriesjabloon.

Formule Omschrijving Result
Split( Concat( Products, Name, ", " ), ", " ) Splitst de teksttekenreeks met het scheidingsteken ",". Een tabel met één kolom met een Value-kolom met de volgende waarden: "Violin", "Cello", "Trumpet"