Функції Concat і Concatenate

Застосовується до: стовпців Dataverse формул програм Canvas Потоки робочого столу Програм, Power Platform керованих моделлю, CLI

Об’єднання окремих рядків тексту та рядків у таблицях.

Опис

Функція Concatenate об’єднує окремі рядки і таблицю з одним стовпцем рядків. Коли ви використовуєте цю функцію з окремими рядками, це еквівалентно використанню оператора the &....

Функція Concat об’єднує результат застосування формули до всіх записів таблиці, що призводить до створення одного рядка. За допомогою цієї функції можна звести рядки таблиці так само, як функція Sum підсумовує числа.

Поля оброблюваного запису доступні у формулі. Використовуйте оператор ThisRecord або просто вкажіть посилання на поля за іменем, як у випадку з будь-яким іншим значенням. Оператор As також можна використовувати для призначення імені оброблюваного запису, що спростить сприймання формули та зробить вкладені записи доступними. Додаткову інформацію див. у прикладах нижче та в статті Робота з областю застосування записів.

Скористайтеся функцією Split або MatchAll, щоб розділити рядок на таблицю підрядків.

Синтаксис

Concat( таблиця, формула, роздільник)

  • Table – обов’язковий аргумент. Це таблиця, для якої потрібно виконати операцію.
  • Formula – обов’язковий аргумент. Формула, що застосовується до записів таблиці.
  • Роздільник — необов’язковий аргумент. Текстове значення, яке потрібно вставити між об'єднаними рядками таблиці.

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

  • String(s) – обов’язковий аргумент. Поєднання окремих рядків або таблиці з одним стовпцем рядків.

Приклади

У прикладах, наведених у цьому розділі, використовуються нижчезазначені глобальні змінні.

  • FirstName = "Jane"
  • LastName = "Doe"
  • Продукти = Таблиця з двома стовпцями і чотирма рядками.

Щоб створити ці глобальні змінні в програмі, вставте елемент керування Кнопка та настройте його властивість OnSelect відповідно до наведеної нижче формули.

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

Натисніть кнопку (клацніть її, утримуючи натиснутою клавішу Alt).

Функція «Concatenate» і оператор «&»

Для цих прикладів настройте властивість Text елемента керування Підпис відповідно до формули із першого стовпця наступної таблиці.

Формула Опис Результат
Concatenate( LastName, ", ", FirstName ) Об’єднання значення в LastName, рядка «, » (кома з пробілом) і значення у FirstName. "Doe, Jane"
Прізвище & ", " & Ім’я Те саме, що й у попередньому прикладі, за винятком використання оператора & замість функції. "Doe, Jane"
Concatenate( FirstName, " ", LastName ) Об’єднання значення у FirstName, рядка « » (пробіл) і значення в LastName. "Jane Doe"
Ім’я & " " & Прізвище Те ж саме, що і в попередньому прикладі, з використанням оператора & замість функції. "Jane Doe"

Об’єднання із таблицею з одним стовпцем

Для цього прикладу додайте пустий вертикальний елемент керування Галерея, настройте його властивість Items відповідно формули, указаної в наступній таблиці, а потім додайте підпис у шаблоні галереї.

Формула Опис Результат
Concatenate( "Name: ", Products.Name, ", Type: ", Products.Type ) Об’єднання для кожного запису в таблиці Продукти рядка "Name: " (Ім’я), імені продукту, рядка ", Type: " (Тип) і типу продукту. Таблиця з одним стовпцем зі Value стовпцем, що містить такі значення: "Назва: скрипка, Тип: струна", "Назва: "Віолончель, Тип: Струна", "Назва: Труба, Тип: Духовий"

Функція «Concat»

Для цих прикладів настройте властивість Text елемента керування «Підпис» відповідно до формули із першого стовпця наступної таблиці.

Формула Опис Результат
concat( продукти, назва, ", " ) Обчислює вираз Ім’я для кожного запису Товарів і об’єднує результати в один текстовий рядок, розділений символом ", ". «Скрипка», «Віолончель», «Труба»
concat( продукти, "’" & назва & "’", ", " ) Обчислює вираз "’" & Ім’я & "’’" для кожного запису Товарів і об’єднує результати в один текстовий рядок, розділений символом ", " . «Скрипка», «Віолончель», «Труба»
concat( filter( products, type = "string" ), name, ", " ) Обчислює формулу Ім’я для кожного запису Товарів , що задовольняє фільтру Тип = "Рядок", і об’єднує результати в один текстовий рядок, розділений символом ", ". "Скрипка, віолончель"

Функції «Split» і «MatchAll»

Якщо ви використовували Concat з роздільником, ви можете скасувати операцію за допомогою функції Split .

Для цих прикладів додайте пустий вертикальний елемент керування «Галерея», настройте його властивість Items відповідно до формули, указаної в наступній таблиці, а потім додайте підпис у шаблоні галереї.

Формула Опис Результат
split( concat( продукти, назва, ", " ), ", " ) Розділення текстового рядка за допомогою роздільника «, ». Таблиця з одним стовпцем зі Value стовпцем, що містить такі значення: «Скрипка», «Віолончель», «Труба»