CRecordset::AddNew

Artigo
08/25/2010

Prepara para adicionar um novo registro à tabela.

virtual void AddNew( );

Comentários

Você deve telefonar o Repetir a consultafunção de membro para ver o registro recém-adicionado.Campos do registro são inicialmente nulo.(Na terminologia de banco de dados nulo significa "não tendo nenhum valor" e não é igual aNULO in C++.) Para concluir a operação, você deve chamar o Atualizaçãofunção de membro .Atualização salva as alterações feitas na fonte de dados.

Observação:
Se você implementou a busca de linha em massa, você não poderá telefonar AddNew.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 AddNew.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).

AddNew Prepara um registro novo, vazio usando membros de dados de campo do conjunto de registros. Depois que você telefonar AddNew, defina os valores desejados em membros de dados de campo do conjunto de registros. (Você não tem telefonar o edição membro funcionar para esse fim; use edição somente para os registros existentes.) Quando você subseqüentemente telefonar Atualização, os valores alterados nos membros de dados do campo são salvos na fonte de dados.

Cuidado:
Se você rolar para um novo registro antes de você telefonar Atualização, o novo registro é perdido, e nenhum aviso é fornecido.

Se a fonte de dados oferece suporte a transações, você poderá tornar o seu AddNew telefonar parte de uma transação. Para obter mais informações sobre transações, consulte classe CDatabase.Observe que você deve telefonar CDatabase::BeginTrans antes telefonar ndo AddNew.

Observação:
Para dynasets, novos registros são adicionados ao conjunto de registros sistema autônomo o último registro.Registros adicionados não são adicionados aos snapshots; você deve telefonar Repetir a consulta para atualizar o conjunto de registros.

É ilegal chamar AddNew para um conjunto de registros cuja em aberto função de membro não foi telefonar.A CDBException Se você chamar AddNew para um conjunto de registros que não pode ser anexado ao. Você pode determinar se o conjunto de registros é atualizável chamando CanAppend.

Para obter mais informações, consulte os seguintes artigos: conjunto de registros: Como Recordsets atualizar registros (ODBC)conjunto de registros: Adicionando, atualização e exclusão de registros (ODBC)e Transação (ODBC).