Share via


Propiedad Status (Field ADO)

Indica el estado de un objeto Field.

Valor devuelto

Devuelve un valor FieldStatusEnum. El valor predeterminado es adFieldOK.

Comentarios

Estado del campo de registro

Los cambios realizados en el valor de un objeto Field de la colección Fields de un objeto Record se almacenan en caché hasta que se llama al método Update del objeto. En ese momento, si el cambio del valor de Field produjo un error, OLE DB genera el error DB_E_ERRORSOCCURRED (2147749409). La propiedad Status de cualquiera de los objetos Field de la colección Fields que provocó el error contendrá un valor de FieldStatusEnum que describe la causa del problema.

Para mejorar el rendimiento, las adiciones y eliminaciones en las colecciones Fields del objeto Record se almacenan en caché hasta que se llama al método Update y, a continuación, los cambios se realizan en una actualización optimista por lotes. Si no se llama al método Update, el servidor no se actualiza. Si se produce un error en las actualizaciones, se devuelve un error del proveedor OLE DB (DB_E_ERRORSOCCURRED) y la propiedad Status indica los valores combinados del código de estado de error y operación. Por ejemplo, adFieldPendingInsert O adFieldPermissionDenied. La propiedad Status de cada objeto Field se puede usar para determinar por qué no se agregó, modificó o eliminó el objeto Field.

Muchos tipos de problemas detectados al agregar, modificar o eliminar un objeto Field se notifican a través de la propiedad Status. Por ejemplo, si el usuario elimina un objeto Field, se marca para su eliminación de la colección Fields. Si la actualización posterior devuelve un error porque el usuario intentó eliminar un objeto Field para el que no tiene permiso, el objeto Field tendrá una propiedad Status de adFieldPermissionDenied O adFieldPendingDelete. Al llamar al método CancelUpdate se restauran los valores originales y se establece la propiedad Status en adFieldOK.

Del mismo modo, el método Update puede devolver un error porque se agregó un nuevo objeto Field y se le asignó un valor inadecuado. En ese caso, el nuevo objeto Field estará en la colección Fields y tendrá un estado de adFieldPendingInsert y quizás adFieldCantCreate (dependiendo de su proveedor). Puede proporcionar un valor adecuado para el nuevo objeto Field y llamar a Update de nuevo.

Estado del campo del conjunto de registros

Los cambios realizados en el valor de un objeto Field de la colección Fields de un objeto Recordset se almacenan en caché hasta que se llama al método Update del objeto. En ese momento, si el cambio del valor de Field produjo un error, OLE DB genera el error DB_E_ERRORSOCCURRED (2147749409). La propiedad Status de cualquiera de los objetos Field de la colección Fields que provocó el error contendrá un valor de FieldStatusEnum que describe la causa del problema.

Se aplica a

Objeto Field

Consulte también

Ejemplo de la propiedad de estado (campo) (VB)
Ejemplo de la propiedad de estado (VC ++)