Compartir a través de


Objeto Error (ADO)

Se aplica a: Access 2013, Office 2013

Contiene detalles sobre errores de acceso a datos relacionados con una operación única que implica al proveedor.

Comentarios

Toda operación que implique a objetos de ADO puede generar errores relacionados con el proveedor. Cuando se produce alguno de estos errores, se colocan objetos Error en la colección Errors del objeto Connection. Cuando otra operación ADO genera un error, se borra la colección Errors y el nuevo conjunto de objetos Error se coloca en la colección Errors.

Nota:

Cada objeto Error representa el error de un proveedor específico, no un error de ADO. Los errores de ADO se exponen al mecanismo de control de excepciones en tiempo de ejecución. Por ejemplo, en Microsoft Visual Basic, la generación de un error específico de ADO desencadenará un evento On Error y aparecerá el objeto Error. Para obtener una lista completa de errores de ADO, vea el tema correspondiente a ErrorValueEnum.

Puede leer las propiedades de un objeto Error para obtener detalles específicos de cada error, como por ejemplo:

  • La propiedad Description, que contiene el texto del error. Esta es la propiedad predeterminada.

  • La propiedad Number, que contiene al valor entero de tipo Long de la constante del error.

  • La propiedad Source, que identifica el objeto que generó el error. Esto es sumamente útil cuando se tienen varios objetos Error en la colección Errors tras realizar una solicitud a un origen de datos.

  • Las propiedades SQLState y NativeError, que proporcionan información de orígenes de datos SQL.

Cuando se produce un error de proveedor, se coloca en la colección Errors del objeto Connection. ADO admite la devolución de varios errores mediante una única operación de ADO para proporcionar información específica de errores al proveedor. Para obtener esta valiosa información de errores en un controlador de errores, utilice las características de intercepción de errores apropiadas del lenguaje o del entorno con el que está trabajando y, a continuación, use bucles anidados para enumerar las propiedades de cada objeto Error de la colección Errors.

Usuarios de Microsoft Visual Basic y VBScriptSi no hay ningún objeto Connection válido, deberá recuperar información de error del objeto Error .

Del mismo modo que hacen los proveedores, ADO borra el objeto OLE Error Info antes de realizar una llamada que pueda generar un nuevo error de proveedor. Sin embargo, la colección Errors del objeto Connection se borra y se rellena sólo cuando el proveedor genera un nuevo error, o cuando se llama al método Clear.

Algunos métodos y propiedades devuelven advertencias que aparecen como objetos Error en la colección Errors pero que no detienen la ejecución de un programa. Antes de llamar a los métodos Resync, UpdateBatch o CancelBatch en un objeto Recordset, antes de llamar al método Open en un objeto Connection, y antes de establecer la propiedad Filter en un objeto Recordset, llame al método Clear en la colección Errors. De este modo, podrá leer la propiedad Count de la colección Errors y comprobar si se devuelven advertencias.