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 之间。”