Share via

Objeto de error

  • Artículo

Contiene detalles sobre los errores de acceso a datos que pertenecen a una sola operación que implica al proveedor.

Comentarios

Cualquier operación que implique objetos de ADO puede generar uno o varios errores de proveedor. A medida que se produce cada error, uno o varios objetos Error se colocan en la colección Errors del objeto Connection. Cuando otra operación de 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 un error de 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 repetición de un error específico de ADO desencadenará un evento On Error y aparecerá en el objeto Error. Para una lista completa de errores de ADO, consulte el tema ErrorValueEnum.

Puede leer las propiedades de un objeto Error para obtener detalles específicos sobre cada error, incluidos los siguientes:

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

  • La propiedad Number, que contiene el valor entero Long de la constante de error.

  • La propiedad Source, que identifica el objeto que generó el error. Esto resulta especialmente útil cuando tiene varios objetos Error en la colección Errors después de 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 sola operación de ADO para permitir información de error específica del proveedor. Para obtener esta información de error enriquecida en un controlador de errores, use las características de captura de errores adecuadas del lenguaje o el entorno con el que está trabajando y, luego, use bucles anidados para enumerar las propiedades de cada objeto Error de la colección Errors.

Nota

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

Al igual que lo hacen los proveedores, ADO borra el objeto OLE Error Info antes de hacer una llamada que podría generar un nuevo error de proveedor. Sin embargo, la colección Errors del objeto Connection se borra y se rellena solo cuando el proveedor genera un nuevo error o cuando se llama al método Clear.

Algunas propiedades y métodos devuelven advertencias que aparecen como objetos Error en la colección Errores, pero que no detienen la ejecución del programa. Antes de llamar a los métodos Resync, UpdateBatch o CancelBatch en el objeto Conjunto de registros; el método Open en un objeto Connection; o establece la propiedad Filter en un objeto Conjunto de registros, llame al método Clear en la colección Errores. De este modo, puede leer la propiedad Count de la colección de Errores para probar las advertencias devueltas.

El objeto Error no es seguro para scripting.

Esta sección contiene los temas siguientes.

Consulte también

Ejemplo de las propiedades Description, HelpContext, HelpFile, NativeError, Number, Source y SQLState (VB)
Ejemplo de las propiedades Description, HelpContext, HelpFile, NativeError, Number, Source y SQLState (VC++)
Objeto de conexión (ADO)
Colección de errores (ADO)
Apéndice A: Proveedores