Функции Concat и Concatenate

Применимо к: Приложениям Canvas Dataverse Столбцам формул Потокам рабочего стола Приложениям на основе моделей Power Pages Power Platform CLI

Объединяют отдельные строки текста и строки в таблицах.

Описание

Функция Concatenate объединяет сочетание отдельных строк и таблицу из одного столбца со строками. При использовании с отдельными строками эта функция эквивалентна использованию оператора &.

Функция Concat объединяет результат формулы, примененной ко всем записям таблицы, в результате чего получается одна строка. Используйте эту функцию для объединения строк таблицы, как функция Sum делает с числами.

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

Используйте функцию Split или MatchAll, чтобы разбить строку на таблицу с подстроками.

Синтаксис

Concat( Таблица, Формула, разделитель)

  • Таблица - Обязательно. Таблица, с которой выполняются операции.
  • Формула - Обязательно. Формула, которую необходимо применить к записям таблицы.
  • Разделитель - Необязательно. Текстовое значение, которое нужно вставить между объединенными строками таблицы.

Объединить( Строка1 [, Строка2, ...] )

  • Строки - обязательны. Сочетание отдельных строк или таблица из одного столбца со строками.

Примеры

Примеры в этом разделе используют следующие глобальные переменные:

  • Имя = "Джейн"
  • Фамилия = "Доу"
  • Продукция = Таблица с двумя столбцами и четырьмя строками.

Чтобы создать эти глобальные переменные в приложении, вставьте элемент управления Button и установить для его свойства 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 элемента управления Label формулу из первого столбца следующей таблицы.

Формула Описание Результат
Объединить( Фамилия, ", ", Имя ) Объединяет значение в LastName, строку ", " (запятая с последующим пробелом) и значение в FirstName. "Doe, Jane"
Фамилия & ", " & Имя То же, что и в предыдущем примере, за исключением использования оператора & вместо функции. "Doe, Jane"
Объединить( Имя, " ", Фамилия ) Объединяет значение в FirstName, строку " " (один пробел) и значение в LastName. "Jane Doe"
Имя & " " & Фамилия То же, что и в предыдущем примере, с использованием оператора & вместо функции. "Jane Doe"

Функция Concatenate с таблицей с одним столбцом

Для этого примера добавьте пустой вертикальный элемент управления Gallery, установите для его свойства Items формулу в следующей таблице, а затем добавьте метку в шаблон коллекции.

Формула Описание Результат
Concatenate( "Имя: ", Products.Name, ", Тип: ", Products.Type ) Для каждой записи в таблице Products объединяет строку "Name: ", название товара, строку ", Type: " и тип продукта. Таблица с одним столбцом со столбцом Value, содержащим следующие значения: "Name: Violin, Type: String", "Name: "Cello, Type: String", "Name: Trumpet, Type: Wind"

Функция Concat

Для этих примеров установите для свойства Text метки формулу из первого столбца следующей таблицы.

Формула Описание: Result
Concat(Продукты, Имя, ", " ) Оценивает выражение Name для каждой записи Products и объединяет результаты в одну текстовую строку ", ". "'Violin', 'Cello', 'Trumpet'"
Concat(Продукты, "'" & Имя & "'", ", " ) Оценивает выражение "'" & Name & "'" для каждой записи Products и объединяет результаты в одну текстовую строку ", ". "'Violin', 'Cello', 'Trumpet'"
Concat( Фильтр( Продукты, Тип = "Строка" ), Имя, ", " ) Оценивает формулу Name для каждой записи Products, которая удовлетворяет фильтру Type = "String" и объединяет результаты в одну текстовую строку, разделенные запятой ", ". "Violin, Cello"

Split и MatchAll

Если вы использовали функцию Concat с разделителем, вы можете выполнить обратную операцию, комбинируя функцию Split.

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

Формула Описание: Result
Split( Concat( Продукты, Имя, ", " ), ", " ) Разбивает текстовую строку с разделителем ", ". Таблица с одним столбцом, в которой столбец Value содержит следующие значения: "Violin", "Cello", "Trumpet"