Error 对象


包含有关数据访问错误的详细信息，这些错误与涉及提供者的单个操作有关。


说明

任何涉及 ADO 对象的操作都可能产生一个或多个提供者错误。随着每个错误的发生，一个或多个 Error 对象被放在 Connection 对象的 Errors 集合中。当另一个 ADO 操作产生错误时，Errors 集合被清空，新的 Error 对象集被放在 Errors 集合中。

注意 每个 Error 对象都表示一个特定的提供者错误，而不是 ADO 错误。ADO 错误被记录到运行时例外处理机制中。例如，在 Microsoft Visual Basic 中，发生 ADO 特有的错误将引发 On Error 事件，并且出现在 Error 对象中。关于 ADO 错误的完整列表，请参阅 ErrorValueEnum 主题。

可以读取 Error 对象的属性以获取关于每个错误的特定细节，包括以下内容：

Description 属性，包含错误的文本。这是默认的属性。


Number 属性，包含错误常量的 Long 整数值。


Source 属性，标识产生错误的对象。在向数据源发出请求后，如果 Errors 集合中有多个 Error 对象，那么该属性将非常有用。


SQLState 和 NativeError 属性，提供来自 SQL 数据源的信息。
当发生提供者错误时，它被放在 Connection 对象的 Errors 集合中。ADO 支持通过单个 ADO 操作返回多个错误，以允许提供者特有的错误信息。若要在错误处理程序中获取更多此类错误信息，请使用相应的语言或所在工作环境下的错误捕获功能，然后使用嵌套的循环来枚举 Errors 集合中每一个 Error 对象的属性。

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

与提供者的操作一样，ADO 在进行可能产生新提供者错误的调用前将清空 OLE Error Info 对象。但是，只有当提供者产生新的错误或者调用 Clear 方法时，才能清空并预置 Connection 对象的 Errors 集合。

某些属性和方法返回警告，这些警告显示为 Errors 集合中的 Error 对象，但并不终止程序的执行。请先调用 Errors 集合的 Clear 方法，然后再调用 Recordset 对象的 Resync、UpdateBatch 或 CancelBatch 方法，调用 Connection 对象的 Open 方法，或设置 Recordset 对象的 Filter 属性。这样，就可以读取 Errors 集合的 Count 属性以测试返回的警告。

Description 属性


描述 Error 对象。

返回值

返回 String 值，包含错误的描述。

说明

用 Description 属性获取简短的错误描述。显示此属性向用户警告您不能或不想处理的错误。该字符串将来自 ADO 或提供者。

提供者负责向 ADO 传递特定的错误文本。对于接收到的每一个提供者错误或警告，ADO 都会向 Errors 集合中添加一个 Error 对象。枚举 Errors 集合以跟踪提供者传递的错误。

Number 属性


指示唯一标识 Error 对象的数字。

返回值

返回 Long 值，该值可能对应于一个 ErrorValueEnum 常量。

说明

使用 Number 属性确定发生了哪个错误。属性的值是与错误条件对应的唯一数字。

Errors 集合以十六进制格式（例如 0x80004005）或以 Long 值（例如 2147467259）返回 HRESULT。这些 HRESULT 由基本组件生成，如 OLE DB，甚至是 OLE 本身。

Source 属性 (ADO Error)


指示最初产生错误的对象或应用程序的名称。

返回值

返回 String 值，指示对象或应用程序的名称。

说明

使用 Error 对象的 Source 属性以确定最初产生错误的对象或应用程序的名称。它可能是对象的类名称或编程 ID。对于 ADO 中的错误，属性值将为 ADODB.ObjectName，此 ObjectName 为触发错误的对象名称。对于 ADOX 和 ADO MD，该值将分别为 ADOX.ObjectName 和 ADOMD.ObjectName。

基于 Error 对象的 Source、Number 和 Description 属性中的错误文档，可以编写处理错误的适当代码。

对于 Error 对象，Source 属性为只读。

SQLState 属性


指示给定 Error 对象的 SQL 状态。

返回值

返回符合 ANSI SQL 标准的五个字符的 String 值，用于指示错误代码。

说明

如果在处理 SQL 语句过程中发生错误，请用 SQLState 属性读取提供者返回的五个字符的错误代码。例如，当配合使用 Microsoft OLE DB Provider for ODBC 和 Microsoft SQL Server 数据库时，将根据 ODBC 特有的错误或 Microsoft SQL Server 生成的错误从 ODBC 生成 SQL 状态错误代码，并将错误代码映射到 ODBC 错误上。这些错误代码在 ANSI SQL 标准中有说明，但是如果数据源不同，其实现方式也会不同。

NativeError 属性


指示给定 Error 对象的提供者特有的错误代码。

返回值

返回 Long 值，指示错误代码。

说明

使用 NativeError 属性对某个 Error 对象检索数据库特有的错误信息。例如，当配合使用 Microsoft ODBC Provider for OLE DB 和 Microsoft SQL Server 数据库时，从 SQL Server 产生的原生错误代码将通过 ODBC 和 ODBC Provider 传递到 ADO NativeError 属性。

Clear 方法


删除 Errors 集合中的所有 Error 对象。

语法

Errors.Clear

说明

使用 Errors 集合的 Clear 方法以删除集合中所有现有的 Error 对象。发生错误时，ADO 将自动清空 Errors 集合，并用基于新错误的 Error 对象填充集合。

某些属性和方法返回警告，这些警告显示为 Errors 集合中的 Error 对象，但并不终止程序的执行。请先调用 Errors 集合的 Clear 方法，再进行如下操作：调用 Recordset 对象的 Resync、UpdateBatch 或 CancelBatch 方法；调用 Connection 对象的 Open 方法；或设置 Recordset 对象的 Filter 属性。这样，就可以读取 Errors 集合的 Count 属性以测试返回的警告。

Errors 集合


包含为响应单个提供者相关失败而创建的 Error 对象。


说明

任何涉及 ADO 对象的操作都可能产生一个或多个提供者错误。在每个错误发生时，一个或多个 Error 对象将被放到 Connection 对象的 Errors 集合中。当另一个 ADO 操作产生错误时，Errors 集合被清空，Error 对象的新集合被放到 Errors 集合中。

每个 Error 对象都表示一个特定的提供者错误，而不是 ADO 错误。ADO 错误被记载到运行时例外处理机制中。例如，在 Microsoft Visual Basic 中，发生 ADO 特有的错误将触发 onError 事件，并且出现在 Err 对象中。

不产生错误的 ADO 操作对 Errors 集合没有影响。使用 Clear 方法手动清除 Errors 集合。

Errors 集合中的 Error 对象集合描述为响应单个语句而发生的所有错误。枚举 Errors 集合中的特定错误可使错误处理例程更精确地判断产生错误的原因和来源，并采取适当的步骤恢复。

某些属性和方法返回警告，这些警告显示为 Errors 集合中的 Error 对象，但并不终止执行程序。先调用 Errors 集合的 Clear 方法，然后再调用 Recordset 对象的 Resync、UpdateBatch 或 CancelBatch 方法，Connection 对象的 Open 方法，或设置 Recordset 对象的 Filter 属性。这样，就可以读取 Errors 集合的 Count 属性以测试返回的警告。

ErrorValueEnum

指定 ADO 运行时错误的类型。

下面列出了错误编号的三种形式：

• 正十进制—十进制格式的完整数字的两个低位字节。此数字在默认的 Visual Basic 错误消息对话框中显示。例如，运行时错误“3707”。
  
  
• 负十进制—完整错误编号的十进制转换。
  
  
• 十六进制—完整错误编号的十六进制表示法。Windows 功能代码位于第四位数字。ADO 错误编号的功能代码为 A。例如：0x800A0E7B。

注意   OLE DB 错误可能传递给用户的 ADO 应用程序。通常，这些错误由 Windows 功能代码 4 标识。例如，0x8004……有关这些编号的详细信息。

ADO/WFC 等价内容

包：com.ms.wfc.data

仅定义了下列 ADO/WFC 等价内容的子集。