Propriedade Status (Field do ADO)

Aplica-se ao: Access 2013, Office 2013

Indica o status de um objeto Field.

Valor de retorno

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

Comentários

Essa propriedade sempre retorna adFieldOK para os campos de um objeto Recordset.

Adições e exclusões executadas nas coleções Fields do objeto Record são armazenadas em cache até que o método Update seja chamado. A propriedade Status permite que você identifique quais campos foram adicionados ou excluídos com êxito.

Para melhorar o desempenho, as alterações de esquema são armazenadas em cache até que o método Update seja chamado e, em seguida, são efetuadas em uma atualização em lote otimista. Se o método Update não for chamado, o servidor não será atualizado. Se as atualizações falharem, um erro será retornado e a propriedade Status indicará os valores combinados da operação e o código de status do erro. Por exemplo, adFieldPendingInsertORadFieldPermissionDenied. 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. O status só é exposto de forma significativa no registro. Fields e não o Recordset. Coleção Fields .

Podem surgir dois problemas durante a adição, modificação ou exclusão de um Field. Se o usuário excluir um Field, ele será marcado para exclusão da coleção Fields. Se a 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 adFieldPermissionDeniedOUadFieldPendingDelete. A chamada do método CancelUpdate restaura os valores originais e define Status como adFieldOK. Da mesma forma, o método Update pode retornar um erro porque um novo Field foi adicionado com um valor inválido. Neste caso, o novo Field estará na coleção Fields e terá o status adFieldPendingInsert e, talvez, adFieldCantCreate. Você pode inserir um valor válido para o novo Field e chamar Update novamente. Em vez disso, a chamada de Resync repete a consulta ao provedor.