다음을 통해 공유


Error 개체

공급자를 포함한 단일 작업과 관련된 데이터 액세스 오류에 대한 세부 정보를 포함합니다.

설명

ADO 개체와 관련된 모든 작업은 하나 이상의 공급자 오류를 생성할 수 있습니다. 오류가 발생할 때마다 하나 이상의 Error 개체가 Connection 개체의 Errors 컬렉션에 배치됩니다. 다른 ADO 작업에서 오류가 발생하면 Errors 컬렉션이 지워지고 새 Error 개체 집합이 Errors 컬렉션에 배치됩니다.

참고

Error 개체는 ADO 오류가 아닌 특정 공급자 오류를 나타냅니다. ADO 오류는 런타임 예외 처리 메커니즘에 노출됩니다. 예를 들어 Microsoft Visual Basic에서 ADO 관련 오류가 발생하면 On Error 이벤트가 트리거되고 Error 개체에 표시됩니다. 전체 ADO 오류 목록은 ErrorValueEnum 항목을 참조하세요.

다음을 포함하여 각 오류에 대한 특정 세부 정보를 얻으려면 Error 개체의 속성을 확인하세요.

  • 오류의 텍스트를 포함하는 Description 속성입니다. 이것이 기본 속성입니다.

  • 오류 상수의 Long 정수 값을 포함하는 Number 속성입니다.

  • 오류를 발생시킨 개체를 식별하는 Source 속성입니다. 이 기능은 데이터 원본에 대한 요청에 따라 Errors 컬렉션에 여러 Error 개체가 있는 경우에 특히 유용합니다.

  • SQL 데이터 원본의 정보를 제공하는 SQLStateNativeError 속성입니다.

공급자 오류가 발생하면 Connection 개체의 Errors 컬렉션에 배치됩니다. ADO는 공급자와 관련된 오류 정보를 허용하기 위해 단일 ADO 작업으로 여러 오류를 반환하도록 지원합니다. 오류 처리기에서 이 풍부한 오류 정보를 가져오려면 작업 중인 언어 또는 환경의 적절한 오류 트래핑 기능을 사용한 다음, 중첩된 루프를 사용하여 Errors 컬렉션에서 각 Error 개체의 속성을 열거합니다.

참고

Microsoft Visual Basic 및 VBScript 사용자 유효한 Connection 개체가 없으면 Error 개체에서 오류 정보를 검색해야 합니다.

공급자와 마찬가지로 ADO는 잠재적으로 새 공급자 오류를 생성할 수 있는 호출을 수행하기 전에 OLE Error Info 개체를 지웁니다. 그러나 Connection 개체의 Errors 컬렉션은 공급자가 새 오류를 생성하거나 Clear 메서드가 호출될 때만 지워지고 채워집니다.

일부 속성 및 메서드는 Errors 컬렉션에 Error 개체로 표시되지만 프로그램 실행을 중단하지 않는 경고를 반환합니다. Recordset 개체에서 Resync, UpdateBatch 또는 CancelBatch 메서드를 호출하기 전에, Connection 개체에서 Open 메서드를 호출하기 전에, Recordset 개체에서 Filter 속성을 설정하기 전에, Errors 컬렉션에서 Clear 메서드를 호출합니다. 이렇게 하면 Errors 컬렉션의 Count 속성을 읽어 반환된 경고를 테스트할 수 있습니다.

Error 개체는 스크립팅에 안전하지 않습니다.

이 섹션에서는 다음 항목을 다룹니다.

참고 항목

Description, HelpContext, HelpFile, NativeError, Number, Source 및 SQLState 속성 예제(VB)
Description, HelpContext, HelpFile, NativeError, Number, Source, SQLState 속성 예제(VC++)
연결 개체(ADO)
Errors 컬렉션(ADO)
부록 A: 공급자