Blank, , CoalesceIsBlankи IsEmpty функции

Functions	Применимо к
Blank	Приложения на основе холста Copilot Studio Desktop потоки формул Dataverse столбцов формулы , управляемые моделью приложений Power Platform CLI Dataverse
Coalesce IsEmpty	Приложения На основе холста Copilot Studio Desktop поддерживают функции Power Platform CLI Dataverse, управляемые моделью
IsBlank	Приложения На основе холста Copilot Studio Desktop потоки формул dataverse, управляемые моделью приложений Power Platform CLI, функции Power Pages

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

Обзор

Blank— это заполнитель для "без значения" или "неизвестного значения". Например, свойство "Выбрано" элемента управления "Поле со списком" пусто, если пользователь не сделал выбор. Многие источники данных могут хранить и возвращать значения NULL, которые в Power Apps рассматриваются как пустые.

Любое свойство или вычисленное значение в Power Apps может быть пустым. Например, логическое значение обычно принимает одно из двух значений: true или false. Но помимо этих двух, он также может быть пустым , указывая, что состояние не известно. Это аналогично Microsoft Excel, где в начале работы ячейки листа пустые без содержимого, но помимо других могут также содержать значения ИСТИНА или ЛОЖЬ. Содержимое ячейки в любое время может быть снова удалено, после чего она снова станет пустой.

Пустая строка относится к строке, не содержащей символов. Функция 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 возвращает пустое значение, если нет формулы else, как показано здесь.

Все аргументы, которые Coalesce должны иметь одинаковый тип, например, нельзя смешивать числа с текстовыми строками. Возвращаемое значение из Coalesce этого общего типа.

IsEmpty

Функция IsEmpty проверяет, содержит ли таблица какие-либо записи. Это аналогично использованию функции CountRows и проверке на наличие нулевых значений. Вы можете проверить наличие ошибок источника данных, объединяя IsEmpty функцию "Ошибки ".

Возвращаемое значение IsEmpty — логическое значение true или false.

Синтаксис

Blank()

Coalesce( Value1 [, Value2, ... ] )

• Значения – обязательны. Проверяемые значения. Каждое значение вычисляется в порядке до тех пор, пока не будет найдено значение, которое не является пустым , а не пустой строкой. Значения после этой точки не оцениваются.

IsBlank( Значение )

• Значение – Обязательно. Значение для проверки на пустое значение или пустую строку.

IsEmpty( Таблица )

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

Примеры

Blank

1. Создайте приложение с нуля и добавьте элемент управления Button.

2. Задайте для свойства кнопки OnSelect эту формулу:

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

3. Просмотрите приложение, нажмите добавленную кнопку, а затем закройте режим предварительного просмотра.

4. В меню Файл щелкните или коснитесь Коллекции.

   После этого отобразится коллекция Cities с одной записью со значениями Seattle (Сиэтл) и Rainy (Дождливо):

   

5. Нажмите кнопку со стрелкой "Назад", чтобы вернуться в рабочую область по умолчанию.

6. Добавьте элемент управления Label и задайте в качестве значения свойства Text следующую формулу:

   IsBlank( First( Cities ).Weather )
   

   Метка отображает значение false, так как поле Weather содержит значение (Rainy).

7. Добавьте вторую кнопку и задайте в качестве значения свойства OnSelect следующую формулу:

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

8. Просмотрите приложение, нажмите добавленную кнопку, а затем закройте режим предварительного просмотра.

   Из поля Weather первой записи в коллекции Cities удалили Rainy, в результате чего оно стало пустым.

   

   Метка отображает значение true, так как в поле Weather отсутствует значение.

Coalesce

IsBlank

1. Создайте приложение с нуля, добавьте элемент управления Text input и назовите его FirstName.

2. Добавьте метку и установите в ее свойстве Text формулу:

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

   По умолчанию свойство Text элемента управления Text input имеет значение Ввод текста. Так как свойство содержит значение, оно не пустое и метка не отображает никакие сообщения.

3. Удалите все символы из элемента управления Text input, в том числе пробелы.

   Так как свойство Text больше не содержит символов, это пустая строка и IsBlank(FirstName.Text)имеет значение true. Отобразится сообщение "Обязательное поле".

Сведения о выполнении проверки с помощью других средств см. в статьях о функции Validate и о работе с источниками данных.

Другие примеры:

IsEmpty

1. Создайте приложение с нуля и добавьте элемент управления Button.

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 , является ли вычисляемая таблица пустой, как показано в следующих примерах: