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 (含) 之間。 如果資料通過驗證，此函式會傳回 空白。 否則，此函式會傳回錯誤訊息。

對單一欄位進行驗證

對完整記錄進行驗證