CRecordset::atualização

Artigo
08/25/2010

Conclui um AddNew ou edição operação salvando os dados novos ou editados na fonte de dados.

virtual BOOL Update( );

Valor de retorno

Diferente de zero se um registro foi atualizado com êxito; caso contrário, 0 se não há colunas foram alteradas.Se não há registros foram atualizados ou se mais de um registro foi atualizado, uma exceção é lançada.Uma exceção é lançada também para qualquer Outros falha na fonte de dados.

Comentários

Chamar essa função de membro após uma telefonar para o AddNew or ediçãofunção de membro .Essa telefonar é necessária para concluir o AddNew ou edição operação.

Observação:
Se você implementou a busca de linha em massa, você não poderá telefonar Atualização.Isso resultará em uma declaração com falha.Embora a classe CRecordset não fornece um mecanismo para a atualização em massa linhas de dados, você pode gravar suas próprias funções utilizando a função de API do ODBC SQLSetPos.Para obter mais informações sobre buscar a linha em massa, consulte o artigo conjunto de registros: Buscando os registros em massa (ODBC).

Se você implementou a busca de linha em massa, você não poderá telefonar Atualização.Isso resultará em uma declaração com falha.Embora a classe CRecordset não fornece um mecanismo para a atualização em massa linhas de dados, você pode gravar suas próprias funções utilizando a função de API do ODBC SQLSetPos.Para obter mais informações sobre buscar a linha em massa, consulte o artigo conjunto de registros: Buscando os registros em massa (ODBC).

Ambos os AddNew e Editar preparar um buffer de edição no qual os dados adicionados ou editados são colocados para salvar a fonte de dados.Atualização salva os dados.Apenas sistema autônomo campos marcados ou detectado sistema autônomo alterados são atualizados.

Se a fonte de dados oferece suporte a transações, você poderá tornar o Atualização telefonar (e seus correspondente AddNew ou edição telefonar) parte de uma transação.Para obter mais informações sobre transações, consulte o artigo Transação (ODBC).

Cuidado:
Se você chamar Atualização sem primeiro chamar qualquer um dos AddNew ou edição, Atualização throws a CDBException. Se você chamar AddNew ou edição, você deve chamar Atualização antes de chamar um Mover operação ou antes de fechar o conjunto de registros ou a conexão de fonte de dados.Caso contrário, suas alterações serão perdidas sem notificação.

Se você chamar Atualização sem primeiro chamar qualquer um dos AddNew ou edição, Atualização throws a CDBException. Se você chamar AddNew ou edição, você deve chamar Atualização antes de chamar um Mover operação ou antes de fechar 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 manipulação de Atualização falhas, consulte o artigo conjunto de registros: Como Recordsets atualização de registros (ODBC).