Propriedade Status (campo ADO)
Indica o status de um objeto Field.
Valor retornado
Retorna um valor FieldStatusEnum. O valor padrão é adFieldOK.
Observações
Status do campo de registro
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. Nesse ponto, se a alteração no valor do campo causou um erro, o OLE DB gerará o erro DB_E_ERRORSOCCURRED (2147749409). A propriedade Status de qualquer um dos objetos Field na coleção Fields que causou o erro conterá um valor do FieldStatusEnum descrevendo a causa do problema.
Para melhorar o desempenho, as adições e exclusões às coleções Fields do objeto Record são armazenadas em cache até que o método de Atualização de seja chamado e, em seguida, 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 as atualizações falharem, 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 OR adFieldPermissionDenied. A propriedade Status para cada Field pode ser usada para determinar por que a de Campo de não foi adicionada, modificada ou excluída.
Muitos tipos de problemas encontrados ao adicionar, modificar ou excluir um de Campo são relatados por meio da propriedade status. Por exemplo, se o usuário excluir um campo , ele será marcado para exclusão da coleção Campos do. Se o Atualização subsequente retornar um erro porque o usuário tentou excluir um campo para o qual não tem permissão, o campo terá um status de adFieldPermissionDenied OR adFieldPendingDelete. Chamar o método CancelUpdate restaura valores originais e define o status para adFieldOK.
Da mesma forma, o método Update pode 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á um status de adFieldPendingInsert e talvez adFieldCantCreate (dependendo do seu provedor). Você pode fornecer um valor apropriado para o novo de Campo e chamar Atualização novamente.
Status do campo do conjunto de registros
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. Nesse ponto, se a alteração no valor do campo causou um erro, o OLE DB gerará o erro DB_E_ERRORSOCCURRED (2147749409). A propriedade Status de qualquer um dos objetos Field na coleção Fields que causou o erro conterá um valor do FieldStatusEnum descrevendo a causa do problema.
Aplica-se a
Consulte Também
Exemplo da propriedade de status (campo) (VB)
Exemplo da propriedade de status (VC++)