Функции Concat и Concatenate

Применимо к: приложениям на основе холста столбцам формул Dataverse классическим потокам приложениям на основе модели интерфейсу командной строки Power Platform

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

Описание

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

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

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

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

Синтаксис

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

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

Concatenate( Строка1 [, Строка2, ...] )

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

Примеры

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

  • FirstName = "Jane"
  • LastName = "Doe"
  • Товары = Таблица с двумя столбцами и четырьмя строками.

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

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

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

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

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

Функция Concat

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

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

Split и MatchAll

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

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

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