CVErr 함수

적용 대상
Microsoft 365용 Access Access 2021 Access 2019 Access 2016

사용자가 지정한 오류 번호가 포함된 하위 형식 오류 의 변형을 반환합니다.

구문

CVErr(errornumber)

필요한 errornumber인수는 유효한 오류 번호입니다.

주의

CVErr 함수를 사용하여 사용자가 만든 프로시저에서 사용자 정의 오류를 만듭니다. 예를 들어 여러 인수를 수락하고 일반적으로 문자열을 반환하는 함수를 만드는 경우 함수에서 입력 인수를 평가하여 허용 범위 내에 있는지 확인하도록 할 수 있습니다. 그렇지 않은 경우 함수가 예상한 것을 반환하지 않을 가능성이 높습니다. 이 경우 CVErr 을 사용하면 수행할 작업을 알려주는 오류 번호를 반환할 수 있습니다.

오류의 암시적 변환은 허용되지 않습니다. 예를 들어 CVErr 의 반환 값을 Variant가 아닌 변수에 직접 할당할 수 없습니다. 그러나 CVErr에서 반환된 값의 명시적 변환(CInt, CDbl 등을 사용)을 수행하고 이를 적절한 데이터 형식의 변수에 할당할 수 있습니다.

예제

참고

VBA(Visual Basic for Applications) 모듈에서 이 함수를 사용하는 경우를 예로 들어 보겠습니다. VBA 사용에 대해 자세히 알아보려면 검색 옆의 드롭다운 목록에서 개발자 참고를 선택하고 검색 상자에 검색어를 하나 이상 입력하세요.

이 예제에서는 CVErr 함수를 사용하여 VarType이vbError(10)인 Variant를 반환합니다. 전달된 인수가 숫자가 아니면 사용자 정의 함수 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