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( Scores, Percentage, 10 ) 檢查 10 是否為 Scores 資料來源中 Percentage 資料行的有效值。 空白
Validate( Scores, Percentage, 120 ) 檢查 120 是否為 Scores 資料來源中 Percentage 資料行的有效值。 「值必須介於 0 與 100 之間」。

對完整記錄進行驗證

公式 說明 結果
Validate( Scores, EditRecord, Gallery.Updates ) 檢查 10 是否為 Scores 資料來源中 Percentage 資料行的有效值。 空白
Validate( Scores, EditRecord, Gallery.Updates ) 檢查 120 是否為 Scores 資料來源中 Percentage 資料行的有效值。 「值必須介於 0 與 100 之間」。