Error 对象

包含与涉及提供程序的单个操作相关的数据访问错误的详细信息。

言论

涉及 ADO 对象的任何操作都可以生成一个或多个提供程序错误。 发生每个错误时,将一个或多个 错误 对象放置在 Connection 对象的 Errors 集合中。 当另一个 ADO 操作生成错误时,将清除 Errors 集合,并将新的 Error 对象集放置在 Errors 集合中。

注意

每个 Error 对象表示特定的提供程序错误,而不是 ADO 错误。 ADO 错误将公开给运行时异常处理机制。 例如,在 Microsoft Visual Basic 中,特定于 ADO 的错误的发生将触发 错误 事件,并显示在 Error 对象中。 有关 ADO 错误的完整列表,请参阅 ErrorValueEnum 主题。

可以读取 错误 对象的属性,以获取有关每个错误的特定详细信息,包括以下内容:

  • Description 属性,该属性包含错误的文本。 这是默认属性。

  • Number 属性,该属性包含错误常量的 Long 整数值。

  • Source 属性,该属性标识引发错误的对象。 在向数据源请求后,Errors 集合中有多个 错误 对象时,这特别有用。

  • SQLStateNativeError 属性,这些属性提供来自 SQL 数据源的信息。

发生提供程序错误时,它将放置在 Connection 对象的 Errors 集合中。 ADO 支持通过单个 ADO 操作返回多个错误,以便提供特定于提供程序的错误信息。 若要在错误处理程序中获取此丰富的错误信息,请使用所使用的语言或环境的适当错误捕获功能,然后使用嵌套循环枚举 Errors 集合中每个 Error 对象的属性。

注意

Microsoft Visual Basic 和 VBScript 用户 如果没有有效的 连接 对象,则需要从 错误 对象中检索错误信息。

正如提供程序所做的那样,ADO 在进行可能生成新提供程序错误的调用之前,先清除 OLE 错误信息 对象。 但是,仅当提供程序生成新错误或调用 Clear 方法时,才会清除和填充 连接 对象的 Errors 集合。

某些属性和方法返回警告,这些警告在 Errors 集合中显示为 Error 对象,但不停止程序的执行。 在调用 ResyncUpdateBatchCancelBatch 方法 Recordset 对象之前;Connection 对象的 Open 方法;或在 Recordset 对象上设置 Filter 属性,对 Errors 集合调用 Clear 方法。 这样,就可以读取 Errors 集合的 Count 属性,以测试返回的警告。

Error 对象不适合编写脚本。

本节包含以下主题。

另请参阅

说明、HelpContext、HelpFile、NativeError、Number、Source 和 SQLState 属性示例 (VB)
说明、HelpContext、HelpFile、NativeError、Number、Source 和 SQLState 属性示例(VC++)
连接对象 (ADO)
错误收集 (ADO)
附录 A:提供程序