Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Contiene detalles sobre los errores de acceso a datos que pertenecen a una sola operación que implica al proveedor.
Observaciones
Cualquier operación que implique objetos ADO puede generar uno o varios errores de proveedor. A medida que se produce cada error, uno o varios objetos de 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 aparición de un error específico de ADO desencadenará un evento On Error y aparecerá en el objeto Error . Para obtener una lista completa de los 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. Esta 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 el retorno 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 adecuadas de captura de errores del lenguaje o 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 .
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 de información de error OLE antes de realizar 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 Errors , pero no detiene la ejecución de un programa. Antes de llamar a los métodos Resync, UpdateBatch o CancelBatch en un objeto Recordset ; el método Open en un objeto Connection ; o establezca la propiedad Filter en un objeto Recordset , llame al método Clear en la colección Errors . De este modo, puede leer la propiedad Count de la colección Errors para probar las advertencias devueltas.
El objeto Error no es seguro para el scripting.
Esta sección contiene el tema siguiente.
Véase también
Description, HelpContext, HelpFile, NativeError, Number, Source y SQLState (VB)
Descripción, HelpContext, HelpFile, NativeError, Número, Origen y Ejemplo de propiedades sqlState (VC++)
Objeto de conexión (ADO)
colección de errores (ADO)
Apéndice A: Proveedores