Blank, Coalesce, IsBlankі IsEmpty функції

Функції	Застосовується до
Blank	Canvas apps Copilot Studio Desktop flows Dataverse formula columns Model-driven apps Power Platform CLI Dataverse functions
Coalesce IsEmpty	Програми Canvas Copilot Studio Desktop flows Model-driven apps Power Platform CLI Dataverse functions Power Pages
IsBlank	Canvas apps Copilot Studio Desktop flows Dataverse formula columns Model-driven apps Power Platform CLI Dataverse functions Power Pages

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

Зведення

Blank– це покажчик місця заповнення для "без значення" або "невідомого значення". Наприклад, властивість Selected елемента керування "Поле зі списком"пуста, якщо користувач не зробив вибір. Багато джерел даних можуть зберігати і повертати значення «NULL», представлені в Power Apps як пусті.

Властивості або обчислювані значення в Power Apps можуть бути пустими. Наприклад, логічне значення зазвичай має одне з двох значень: true або false. Але на додаток до цих двох, це також може бути пустим , що вказує на те, що стан не відомий. Тут можна провести аналогію з програмою Microsoft Excel, у якій клітинка аркуша спочатку може бути пуста, а потім – містити (із-поміж інших) значення TRUE або FALSE. У будь-який момент вміст клітинки може знову бути очищено, а саму клітинку повернуто до пустого стану.

Порожній рядок відноситься до рядка, який не містить символів. Функція Len повертає для таких рядків нуль та може записуватися у формулах як подвійні лапки, між якими нічого немає "". Деякі елементи керування та джерела даних використовують пустий рядок для позначення умови відсутності значення. Щоб спростити IsBlank створення програм, функція та Coalesce функції перевіряються як для пустих значень, так і для пустих рядків.

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

Blank

Функція Blank повертає пусте значення. Використовуйте цю функцію для зберігання значень «NULL» у джерелах даних, що їх підтримують, ефективно видаляючи ці значення з поля.

IsBlank

Функція IsBlank перевіряє пусте значення або пустий рядок. Тест містить пусті рядки, які полегшують створення програм, оскільки деякі джерела даних і елементи керування використовують пустий рядок, коли немає значення. Щоб перевірити конкретно пусте значення, if(Value = Blank(), ... використовуйте замість IsBlank. Функція IsBlank вважає пусті таблиці пустими, тому IsEmpty її слід використовувати для перевірки таблиці.

Активуючи обробку помилок для наявних програм, радимо замінити IsBlankisBlankOrError , щоб зберегти наявну поведінку програм. Перед додаванням обробки помилок пусте значення було використано, щоб представляти Null-значення з баз даних і значень помилок. Під час обробки помилок ці два тлумачення пусті, які можуть змінити поведінку наявних програм, які продовжують використовувати IsBlank.

Значення, яке IsBlank повертається, – це логічне значення true або false.

Coalesce

Функція Coalesce обчислює аргументи в порядку та повертає перше значення, яке не є пустим або пустим рядком. За допомогою цієї функції можна замінити пусте значення або пустий рядок на інше значення, водночас залишаючи непусті значення та непусті рядки незмінними. Якщо всі аргументи пусті або пусті рядки, функція повертає пусті рядки, що дає Coalesce змогу перетворити пусті рядки на пусті значення.

Coalesce( value1, value2 ) є більш стислим еквівалентом If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) і не вимагає подвійної оцінки value1 і value2 . Функція If повертає пусте значення, якщо формула "інакше" відсутня, як це відбувається тут.

Усі аргументи Coalesce мають мати однаковий тип; наприклад, не можна змішувати числа з текстовими рядками. Повернуте значення з Coalesce цього поширеного типу.

IsEmpty

Функція IsEmpty перевіряє, чи містить таблиця записи. Її використання прирівнюється до використання функції CountRows і перевірки наявності значення «нуль». Ви можете перевірити наявність помилок джерела даних, поєднуючи IsEmpty їх із функцією "Помилки ".

Значення, яке IsEmpty повертається, – це логічне значення true або false.

Синтаксис

Blank()

Coalesce( Значення1 [, значення2; ... ] )

• Цінності – обов’язкові . Значення для перевірки. Кожне значення обчислюється в порядку, доки не буде знайдено пусте значення, а не пустий рядок. Значення після цієї точки не обчислюється.

IsBlank( Значення )

• Value – обов’язковий. Значення, щодо якого потрібно виконати перевірку на пусте значення або пустий рядок.

IsEmpty( Таблиця )

• Таблиця - обов’язковий. Таблиця для перевірки на наявність записів.

Приклади

Blank

1. Створіть програму з нуля, а потім додайте елемент керування Кнопка.

2. Настройте властивість OnSelect кнопки відповідно до нижченаведеної формули.

   ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )
   

3. Для попереднього перегляду програми клацніть додану кнопку (або торкніться її), а потім закрийте попередній перегляд.

4. У меню Файл виберіть Колекції.

   Відобразиться колекція Cities (Міста), що містить один запис із значеннями «Seattle» (Сіетл) і «Rainy» (Дощова погода).

   

5. Натисніть кнопку зі стрілкою назад, щоб повернутися до робочої області за замовчуванням.

6. Додайте елемент керування Підпис і настройте його властивість Text відповідно до вказаної нижче формули.

   IsBlank( First( Cities ).Weather )
   

   Підпис відображає значення false, тому що поле Weather (Погода) містить значення («Rainy»).

7. Додайте іншу кнопку та настройте її властивість OnSelect відповідно до нижчезазначеної формули.

   Patch( Cities, First( Cities ), { Weather: Blank() } )
   

8. Для попереднього перегляду програми клацніть додану кнопку (або торкніться її), а потім закрийте попередній перегляд.

   Поле Weather першого запису в колекції Cities замінюється пустим значенням, а значення «Rainy» видаляється.

   

   Підпис відображає значення true, тому що поле Weather більше не містить значення.

Coalesce

Формула	Опис	Результат
Coalesce( Blank(), 1 )	Перевіряє повернуте значення функції Blank , яке завжди повертає пусте значення. Оскільки перший аргумент є пустим значенням, обчислення продовжується з наступного аргументу, доки не буде знайдено непусте значення або непустий рядок.	1
Coalesce( "", "2" )	Перевіряє перший аргумент , який є пустим рядком. Оскільки перший аргумент є пустим рядком, обчислення продовжується з наступного аргументу, доки не буде знайдено непусте значення або непустий рядок.	2
Coalesce( Blank(), "", Blank(), "", "; "3", "4" )	Coalesce починається на початку списку аргументів і обчислює кожен аргумент по черзі, доки не буде знайдено непусте значення та непустий рядок. У цьому разі перші чотири аргументи повернуть пусте значення або пустий рядок, тому обчислення продовжиться до п’ятого аргументу. П’ятий аргумент є непустим значенням і непустим рядком, тому на ньому обчислення припиниться. Буде повернуто значення п’ятого аргументу, а шостий аргумент не обчислюватиметься.	3
Coalesce( "" )	Перевіряє перший аргумент , який є пустим рядком. Оскільки перший аргумент є пустим рядком, а інші аргументи відсутні, функція повертає пусте значення.	Порожній

IsBlank

1. Створіть програму з нуля, додайте елемент керування «Ввід тексту» та назвіть його FirstName (Ім’я).

2. Додайте надпис і встановіть цю формулу в якості значення його властивості Text:

   If( IsBlank( FirstName.Text ), "First Name is a required field." )
   

   За замовчуванням для властивості Text елемента керування «Ввід тексту» встановлено значення «Text input» (Уведення тексту). Оскільки властивість містить значення, вона не є пустою, і підпис не відображає повідомлення.

3. Видаліть усі символи з елемента керування «Ввід тексту», включно з пробілами.

   Оскільки властивість Text більше не містить жодних символів, це пустий рядок і IsBlank(Ім'я.Текст) має значення true. Відобразиться повідомлення про обов’язкове поле.

Відомості щодо виконання перевірки за допомогою інших засобів див. в статтях про функцію Validate та роботу з джерелами даних.

Нижче наведено інші приклади.

Формула	Опис	Результат
IsBlank( Blank() )	Перевіряє повернуте значення функції Blank , яке завжди повертає пусте значення.	Справжній
IsBlank( "" )	Рядок, що не містить символів.	Справжній
IsBlank( "Привіт" )	Рядок, що містить символ або кілька символів.	Брехня
IsBlank( Будь-якаколекція )	Оскільки колекція існує, вона не є пустою, навіть якщо в ній немає записів. Щоб перевірити наявність пустої колекції, скористайтеся IsEmpty .	Брехня
IsBlank( Mid( "Привіт", 17, 2 )	Початковий символ для Mid знаходиться за межами кінця рядка. Результатом є пустий рядок.	Справжній
IsBlank( Якщо( false, false ) )	Функція If без аргументу ElseResult. Оскільки умова завжди має значення false, ця функція If завжди повертає пусте значення.	Справжній

IsEmpty

1. Створіть програму з нуля, а потім додайте елемент керування Кнопка.

2. Настройте властивість OnSelect кнопки відповідно до нижченаведеної формули.

   Collect( IceCream, {Flavor: "Полуниця", Кількість: 300}, {Смак: "Шоколад", Кількість: 100} )

3. Для попереднього перегляду програми клацніть додану кнопку (або торкніться її), а потім закрийте попередній перегляд.

   Буде створено колекцію з ім’ям IceCream (Морозиво), що містить вказані нижче дані.

   

   Ця колекція складається з двох записів і не є пустою. IsEmpty(IceCream ) повертає значення false, а CountRows( IceCream ) повертає 2.

4. Додайте іншу кнопку та настройте її властивість OnSelect відповідно до нижчезазначеної формули.

   Прозорий ( Морозиво )

5. Для попереднього перегляду програми клацніть вищевказану кнопку (або торкніться її), а потім закрийте попередній перегляд.

   Тепер колекція пуста.

   

   Функція Clear видаляє всі записи з колекції, після чого колекція стає пустою. IsEmpty(IceCream ) повертає значення true, а CountRows( IceCream ) повертає 0.

Також можна перевірити IsEmpty , чи не пуста обчислювана таблиця, як показано в таких прикладах:

Формула	Опис	Результат
IsEmpty( [ 1, 2, 3 ] )	Таблиця з одним стовпцем містить три записи, а тому не є пустою.	Брехня
IsEmpty( [ ] )	Таблиця з одним стовпцем не містить записів і є пустою.	Справжній
IsEmpty( Фільтр( [ 1, 2, 3 ], Значення > 5 ) )	Таблиця з одним стовпцем не містить значень, що перевищують 5. Результат, отриманий за допомогою фільтра, не містить жодних записів і є пустим.	Справжній