Validate 函数
适用于：
画布应用模型驱动应用
Validate 函数检查单个列或整条记录的值对数据源是否有效。
描述
在用户提交数据更改之前，您可以针对该提交的有效性提供即时反馈，改进用户体验。
对于何种要素构成记录中的有效值，数据源可以提供相关信息。 该信息可能包括许多约束，例如以下示例：
- 列是否需要值
- 文本字符串可以有多长
- 一个数字可以有多大和多小
- 一个日期可以有多早和多迟
Validate 函数根据该信息来确定某个值是否有效，并在无效的情况下返回相应的错误消息。 可以通过 DataSourceInfo 函数查看 Validate 所使用的相同信息。
数据源中提供的验证信息量可能不同，甚至可能不提供任何信息。 Validate 只能根据该信息验证值。 即使 Validate 没有发现问题，仍然可能无法应用数据更改。 可以通过 Errors 函数获取有关失败的信息。
如果 Validate 发现问题，该函数会返回错误消息，方便您将其显示给应用用户。 如果所有值都有效，Validate 返回 blank。 使用没有验证信息的集合时，值始终是有效的。
语法
Validate( DataSource, Column, Value )
- DataSource – 必需。 要通过其进行验证的数据源。
- Column – 必需。 要验证的列。
- Value – 必需。 要验证的所选列的值。
Validate( DataSource, OriginalRecord, Updates )
- DataSource – 必需。 要通过其进行验证的数据源。
- OriginalRecord - 必需。 要验证其更新的记录。
- Updates - 必需。 将应用于原始记录的更改。
示例
就这些示例来说，Scores 数据源的 Percentage 列中的值必须为 0 到 100（含）之间。 如果数据通过验证，该函数将返回空白。 否则，该函数返回一条错误消息。
验证单个列
| 公式 | 描述 | 结果 |
|---|---|---|
| Validate( Scores, Percentage, 10 ) | 对于 Scores 数据源的 Percentage 列，检查 10 是否为有效值。 | blank |
| Validate( Scores, Percentage, 120 ) | 对于 Scores 数据源的 Percentage 列，检查 120 是否为有效值。 | “值必须为 0 到 100 之间。” |
验证完整记录
| 公式 | 描述 | 结果 |
|---|---|---|
| Validate( Scores, EditRecord, Gallery.Updates ) | 检查所有列中的值对 Scores 数据源而言是否均有效。 在本例中，Percentage 列中的值是 10。 | blank |
| Validate( Scores, EditRecord, Gallery.Updates ) | 检查所有列中的值对 Scores 数据源而言是否均有效。 在本例中，Percentage 列中的值是 120。 | “值必须为 0 到 100 之间。” |