Validate 函数

适用于： 画布应用 模型驱动应用

该 Validate 函数检查单个 列 或完整 记录 的值是否对 数据源有效。

描述

在用户提交数据更改之前，您可以针对该提交的有效性提供即时反馈，改进用户体验。

对于何种要素构成记录中的有效值，数据源可以提供相关信息。 该信息可能包括许多约束，例如以下示例：

• 列是否需要值
• 文本字符串可以有多长
• 一个数字可以有多大和多小
• 一个日期可以有多早和多迟

该 Validate 函数使用此信息来确定值是否有效，如果不是，则返回相应的错误消息。 可以使用 DataSourceInfo 函数查看所使用的相同信息 Validate 。

数据源中提供的验证信息量可能不同，甚至可能不提供任何信息。 Validate 只能基于此信息验证值。 即使 Validate 找不到问题，应用数据更改也可能失败。 可以通过 Errors 函数获取有关失败的信息。

如果 Validate 发现问题，该函数将返回一条错误消息，可以向用户显示该应用。 如果所有值都有效， Validate 则返回 空白。 使用没有验证信息的集合时，值始终是有效的。

语法

Validate（ DataSource、 Column、 Value ）

• DataSource – 必需。 要通过其进行验证的数据源。
• Column（列 ）–必需。 要验证的列。
• Value –必需。 要验证的所选列的值。

Validate（ DataSource、 OriginalRecord、 Updates ）

• DataSource – 必需。 要通过其进行验证的数据源。
• OriginalRecord - 必需。 要验证其更新的记录。
• Updates - 必需。 将应用于原始记录的更改。

示例

就这些示例来说，Scores 数据源的 Percentage 列中的值必须为 0 到 100（含）之间。 如果数据通过验证，该函数将返回空白。 否则，该函数返回一条错误消息。

Validate 包含单个列

Validate 包含完整记录