Compartilhar via

Propriedade Status (Field do ADO)

  • Artigo

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 estado só é significativamente exposto no Registo. Coleção de campos e não o Conjunto de registos. Coleção de campos .

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 devolver um erro porque o utilizador tentou eliminar um Campo para o qual não tem permissão, o Campo terá o estado 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.