Validate 函數

適用於： 畫布應用程式 模型導向應用程式

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

描述

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

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

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

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

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

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

語法

Validate（ 數據源， 列， 值 ）

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

Validate（ 數據源， 原始記錄， 更新 ）

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

範例

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

Validate 具有單一資料行

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

Validate 有完整的記錄

公式	描述	結果
Validate（ 分數、編輯記錄、圖庫.更新 ）	檢查所有欄位值是否對 分數 資料來源皆有效。 此範例中，百分比 欄位值是 10。	空白
Validate（ 分數、編輯記錄、圖庫.更新 ）	檢查所有欄位值是否對 分數 資料來源皆有效。 此範例中，百分比 欄位值是 120。	"值必須介於 0 與 100 之間"。