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