CVErr 函式

套用到
Microsoft 365 Access Access 2021 Access 2019 Access 2016

回傳一個包含使用者指定錯誤編號的子型別 Error

語法

CVErr (錯誤編號)

所需的錯誤編號參數是任何有效的錯誤編號。

註解

使用 CVErr 函式在使用者建立的程序中產生使用者定義錯誤。 舉例來說,如果你建立一個接受多個參數且通常回傳字串的函式,你可以讓函式評估輸入參數,確保它們在可接受範圍內。 如果不是,你的函數很可能不會回報你預期的效果。 在這種情況下, CVErr 允許你回傳一個錯誤編號,告訴你應該採取什麼行動。

請注意,不允許對 錯誤 進行隱性轉換。 例如,你無法直接將 CVErr 的回傳值指派給非 變體變數。 不過,你可以用 CIntCDbl 等工具,) CVErr 回傳的值執行明確的轉換 (,並將它指派到適當資料型態的變數上。

範例

注意

下列範例示範如何在 Visual Basic for Applications (VBA) 模組中使用此函數。 如需使用 VBA 的詳細資訊,請在 [搜尋] 旁的下拉式清單中選取 [開發人員參考],並在 [搜尋] 方塊中輸入一個或多個字詞。

此範例使用 CVErr 函式回傳一個變 ,其 VarTypevbError (10) 。 如果傳遞給它的參數不是數字,使用者自訂函式 CalculateDouble 會回傳錯誤。 你可以使用 CVErr 從使用者定義程序回傳使用者定義的錯誤,或延後執行時錯誤的處理。 使用 IsError 函式來測試該值是否代表錯誤。

' Call CalculateDouble with an error-producing argument.
Sub Test()
    Debug.Print CalculateDouble("345.45robert")
End Sub
' Define CalculateDouble Function procedure.
Function CalculateDouble(Number)
    If IsNumeric(Number) Then
        CalculateDouble = Number * 2    ' Return result.
    Else
        CalculateDouble = CVErr(2001)    ' Return a user-defined error 
    End If    ' number.
End Function