Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Применимо к:
Приложения на основе модели на основе холста
Функция Validate проверяет, является ли значение одного столбца или полной записью допустимой для источника данных.
Описание
Вы можете настроить мгновенную проверку пользовательских изменений перед их отправкой, чтобы оптимизировать работу пользователей с данными.
Источники данных могут содержать информацию о том, какие значения в записях считаются допустимыми. Эти сведения могут включать различные ограничения, например:
- требуется ли значение в определенном столбце;
- максимальная допустимая длина для текстовой строки;
- максимальное и минимальное значения для числа;
- нижняя и верхняя границы диапазона для даты.
Эта Validate функция использует эти сведения для определения допустимости значения и возврата соответствующего сообщения об ошибке, если нет. Функцию DataSourceInfo можно использовать для просмотра той же информации, которая Validate используется.
Источники данных различаются по объему доступных сведений о проверке и могут вообще не содержать их. Validate может проверять только значения на основе этих сведений. Даже если Validate не удается найти проблему, применение изменения данных может по-прежнему завершиться ошибкой. Получить информацию о ней можно с помощью функции Errors.
При Validate обнаружении проблемы функция возвращает сообщение об ошибке, которое можно отобразить пользователю приложения. Если все значения допустимы, Validate возвращает пустое значение. При работе с коллекцией, в которой нет информации о проверке, значения всегда считаются действительными.
Синтаксис
Validate( DataSource, Column, Value )
- DataSource — обязательный аргумент. Источник данных, с которым необходимо сверить значение.
- Столбец – Обязательно. Столбец, который необходимо проверить.
- Значение – Обязательно. Значение в выбранном столбце, которое необходимо проверить.
Validate( DataSource, OriginalRecord, Updates )
- DataSource — обязательный аргумент. Источник данных, с которым необходимо сверить значение.
- OriginalRecord - Обязательно. Запись, обновления которой необходимо проверить.
- Обновления - Требуются. Изменения, которые требуется применить к исходной записи.
Примеры
В этих примерах значения в столбце Percentage (Процент) источника данных Scores (Показатели) должны находиться в диапазоне от 0 до 100 включительно. Если данные проходят проверку, функция возвращает пустое значение. В противном случае она возвращает сообщение об ошибке.
Validate с одним столбцом
| Формула | Описание | Результат |
|---|---|---|
| Validate( Оценки, процент, 10 ) | Проверяет, является ли 10 допустимым значением для столбца Percentage в источнике данных Scores. | пустой |
| Validate( Оценки, процент, 120 ) | Проверяет, является ли 120 допустимым значением для столбца Percentage в источнике данных Scores. | "Значения должны быть в диапазоне от 0 до 100". |
Validate с полной записью
| Формула | Описание | Результат |
|---|---|---|
| Validate( Оценки, EditRecord, Gallery.Updates ) | Проверяет, допустимы ли значения во всех столбцах для источника данных Scores. В этом примере значение в столбце Percentage равно 10. | пустой |
| Validate( Оценки, EditRecord, Gallery.Updates ) | Проверяет, допустимы ли значения во всех столбцах для источника данных Scores. В этом примере значение в столбце Percentage равно 120. | "Значения должны быть в диапазоне от 0 до 100". |