Validate 函式

適用於： 畫布應用 模型驅動應用

Validate 函式會檢查單一 欄位 或完整 記錄 的值是否對 資料來源 有效。

描述

您可以在使用者提交資料變更前，立即回應該項提交是否有效，來達到更好的使用者體驗。

資料來源可以提供相關資訊，讓使用者了解如何構成有效的記錄值。 這項資訊可以包含許多條件約束，例如下列範例︰

• 欄位是否需要值
• 文字字串可保留多久
• 數字可以多高和多低
• 日期可以多早和多晚

Validate 函式會使用這項資訊來判斷值是否有效，如果無效則傳回適當的錯誤訊息。 您可以使用 DataSourceInfo 函式檢視 Validate 所使用的相同資訊。

資料來源會依其提供的驗證資訊量而異，包括完全沒有提供任何項目。 Validate 只能根據此資訊驗證值。 即使 Validate 未找到問題，套用資料變更可能仍會失敗。 您可以使用 Errors 函式取得失敗的相關資訊。

如果 Validate 找到問題，該函式就會傳回錯誤訊息，以供您顯示給應用程式的使用者。 如果所有值都有效，Validate 會傳回 空白。 若您使用的 集合物件 沒有驗證資訊，值一律會有效。

語法

驗證（DataSource，Column，Value ）

• DataSource –必需。 要進行驗證的資料來源。
• Column (列 )–必需。 要驗證的欄位。
• Value –必需。 選取欄位內要驗證的值。

驗證（DataSource，OriginalRecord，Updates ）

• DataSource –必需。 要進行驗證的資料來源。
• OriginalRecord - 必需。 更新將接受驗證的記錄。
• Updates - 必需。 要套用至原始記錄的變更。

範例

這些範例中，Scores 資料來源之 Percentage 欄位值必須介於 0 與 100 (含) 之間。 如果資料通過驗證，此函式會傳回 空白。 否則，此函式會傳回錯誤訊息。

對單一欄位進行驗證

公式	描述	結果
驗證（分數，百分比，10）	檢查 10 是否為 Scores 資料來源中 Percentage 欄位的有效值。	空白
驗證（分數，百分比，120）	檢查 120 是否為 Scores 資料來源中 Percentage 欄位的有效值。	"值必須介於 0 與 100 之間"。

對完整記錄進行驗證

公式	描述	結果
驗證（分數、EditRecord、Gallery.Updates）	檢查所有欄位值是否對 分數 資料來源皆有效。 此範例中，百分比 欄位值是 10。	空白
驗證（分數、EditRecord、Gallery.Updates）	檢查所有欄位值是否對 分數 資料來源皆有效。 此範例中，百分比 欄位值是 120。	"值必須介於 0 與 100 之間"。