Propriedade Status (campo ADO)

Indica o status de um objeto Field.

Valor Retornado

Retorna um valor FieldStatusEnum. O valor padrão é adFieldOK.

Comentários

Status do campo Record

As alterações no valor de um objeto Field na coleção Fields de um objeto Record são armazenadas em cache até que o método Update do objeto seja chamado. Neste ponto, se a alteração no valor de Field causou um erro, o OLE DB gera o erro DB_E_ERRORSOCCURRED (2147749409). A propriedade Status de um dos objetos Field na coleção Fields que causou o erro conterá um valor da FieldStatusEnum que descreve a causa do problema.

Para aprimorar o desempenho, as adições e as exclusões nas coleções Fields do objeto Record são armazenadas em cache até que o método Update seja chamado e as alterações são feitas em uma atualização otimista em lote. Se o método Update não for chamado, o servidor não será atualizado. Se alguma atualização falhar, um erro do provedor OLE DB (DB_E_ERRORSOCCURRED) será retornado e a propriedade Status indicará os valores combinados do código de status da operação e do erro. Por exemplo, adFieldPendingInsert OU adFieldPermissionDenied. A propriedade Status de cada Field pode ser usada para determinar o motivo pelo qual o Field não foi adicionado, modificado ou excluído.

Muitos tipos de problemas encontrados na adição, na modificação ou na exclusão de um Field são relatados por meio da propriedade Status. Por exemplo, se o usuário excluir um Field, ele será marcado para exclusão da coleção Fields. Se a Update seguinte retornar um erro porque o usuário tentou excluir um Field no qual ele não tem permissão, o Field terá o StatusadFieldPermissionDenied OU adFieldPendingDelete. A chamada ao método CancelUpdate restaura os valores originais e define o Status como adFieldOK.

Da mesma forma, o método Update poderá retornar um erro porque um novo Field foi adicionado e recebeu um valor inadequado. Nesse caso, o novo Field estará na coleção Fields e terá o status adFieldPendingInsert e talvez adFieldCantCreate (dependendo do provedor). Você pode fornecer um valor apropriado para o novo Field e chamar Update novamente.

Status do campo Recordset

As alterações no valor de um objeto Field na coleção Fields de um Recordset são armazenadas em cache até que o método Update do objeto seja chamado. Neste ponto, se a alteração no valor de Field causou um erro, o OLE DB gera o erro DB_E_ERRORSOCCURRED (2147749409). A propriedade Status de um dos objetos Field na coleção Fields que causou o erro conterá um valor da FieldStatusEnum que descreve a causa do problema.

Aplica-se A

Objeto Campo

Consulte Também

Exemplo da propriedade Status (Campo) (VB)
Exemplo da propriedade Status (VC++)