virtual BOOL Update ( );
lançar ( CDBException );
Valor de retorno
Diferente de zero se um registro foi atualizado com êxito; caso contrário 0 se não há colunas foram alterados. Se nenhum registro foi atualizado, ou se mais de um registro foi atualizado, uma exceção é lançada. Uma exceção também é lançada para qualquer outra falha na fonte de dados.
Observações
Chame essa função de membro após uma chamada para a função de membro AddNew ou Editar . Esta chamada é necessária para concluir o AddNew ou Editar operação.
&Notanbsp; Se tiver implementado em massa linha buscando, não é possível chamar Atualizar. Isso resultará em uma declaração falha. Apesar de classe CRecordset não fornece um mecanismo para atualizar linhas em massa de dados, você pode gravar suas próprias funções, usando a função de API de ODBC SQLSetPos. Para obter um exemplo de como fazer isso, consulte o exemplo de DBFETCH. Para obter mais informações sobre a linha em massa buscando, consulte o artigo Recordset: Buscar registros em massa (ODBC) no Guia do programador do Visual C++.
AddNew e Editar preparam um buffer de edição em que os dados adicionados ou editados são colocados para Salvando a fonte de dados. Atualizar salva os dados. Somente os campos marcados ou detectado como alterados são atualizados.
Se a fonte de dados oferece suporte a transações, você pode fazer a chamada de atualização (e seus correspondente AddNew ou Editar chamar) parte de uma transação. Para obter mais informações sobre transações, consulte o artigo Transações (ODBC) no Guia do programador do Visual C++.
Cuidadonbsp; Se você chamar de atualização sem primeiro chamar o Add&New ou Editar, Atualizar lança um CDBException. Se você chamar AddNew ou Editar, você deve chamar Atualizar antes de chamar uma operação de Mover ou antes de fechar qualquer um o conjunto de registros ou a conexão de fonte de dados. Caso contrário, suas alterações serão perdidas sem notificação.
Para obter detalhes sobre a manipulação de falhas de atualização , consulte o artigo Recordset: como conjuntos de registros atualizar registros (ODBC) no Guia do programador do Visual C++.
Exemplo
Consulte o artigo transação: executar uma transação em um conjunto de registros (ODBC) no Guia do programador do Visual C++.
Visão geral de CRecordset | Membros de classe | Gráfico de hierarquia
Consulte tambémnbsp;CRecordset::Edit, CRecordset::Add&New, CRecordset::SetFieldDirty, CDBException