Conjunto de registros: adicionando, atualizando e excluindo registros (ODBC)
Este tópico se aplica às classes ODBC do MFC.
Dica
Agora você pode adicionar registros em massa mais eficiente.Para obter mais informações, consulte Conjunto de registros: Adicionando registros em massa (ODBC).
Dica
Este tópico se aplica a objetos derivados de CRecordset no qual a busca de linhas do volume não foi implementado.Se você estiver usando a linha em massa que pesquisa, consulte Conjunto de registros: Buscando registros em massa (ODBC).
Os instantâneos e os dynasets atualizáveis permitem adicionar, editar (atualização), e exclui registros. Este tópico explica:
Como determinar se o conjunto de registros é atualizável.
Como adicionar um novo registro.
Como editar um registro existente.
Como excluir um registro.
Para obter mais informações sobre como as atualizações são mantidas e como as atualizações são exibidas a outros usuários, consulte Conjunto de registros: Como registros de atualização dos conjuntos de registros (ODBC). Normalmente, quando você adicionar, editar, excluir ou um registro, as alterações do conjunto de registros a fonte de dados imediatamente. Você pode então processar em lotes grupos de atualizações relacionadas de transações. Se uma transação estiver em andamento, a atualização não se torna final até que você confirme a transação. Isso permite que você faça novamente ou reverta as alterações. Para obter informações sobre transações, consulte Transações (ODBC).
A tabela a seguir resume as opções disponíveis para conjuntos de registros com características diferentes de atualização.
Conjunto de registros ler/opções de atualização
Tipo |
Ler |
Registro de edição |
Excluir registro |
Adicionar novo (adicionar) |
|---|---|---|---|---|
Somente leitura |
Y |
N |
N |
N |
Somente de acréscimo |
Y |
N |
N |
Y |
Completamente atualizável |
Y |
Y |
Y |
Y |
Determinando se o conjunto de registros é Atualizável
Um objeto do conjunto de registros é atualizável se a fonte de dados pode ser atualizado e você abriu o conjunto de registros como atualizáveis. Seu updateability depende também da instrução SQL usada, os recursos do driver ODBC e, se a biblioteca de cursores ODBC estiver na memória. Você não pode atualizar um conjunto de registros ou uma fonte de dados somente leitura.
Para determinar se o conjunto de registros é atualizável
Chame a função de membro de CanUpdate do objeto do conjunto de registros.
CanUpdate retorna um valor diferente de zero se o conjunto de registros é atualizável.
Por padrão, os conjuntos de registros são completamente atualizável (você pode executar AddNew, Editar, e operações de Excluir ). Mas você também pode usar a opção de appendOnly abrir os conjuntos de registros atualizável. Um conjunto de registros abriu essa maneira permite apenas a adição de novos registros com AddNew. Você não pode editar ou excluir registros existentes. Você pode testar se um conjunto de registros é aberto somente para acrescentar chamando a função de membro de CanAppend . CanAppend retorna um valor diferente de zero se o conjunto de registros é completamente atualizado ou aberto somente para acrescentar.
O código a seguir mostra como você pode usar CanUpdate para um objeto do conjunto de registros chamado rsStudentSet:
if( !rsStudentSet.Open( ) )
return FALSE;
if( !rsStudentSet.CanUpdate( ) )
{
AfxMessageBox( "Unable to update the Student recordset." );
return;
}
Aviso
Quando você se prepara para atualizar um conjunto de registros chamando Atualizar, lembre-se que o conjunto de registros inclui todas as colunas que constituem a chave primária da tabela (ou todas as colunas de qualquer índice exclusivo na tabela).Em alguns casos, a estrutura pode usar apenas as colunas selecionadas no conjunto de registros para identificar quais registros na tabela a ser atualizada.Sem todas as colunas necessárias, vários registros podem ser atualizados na tabela, corrompendo possivelmente a integridade referencial da tabela.Nesse caso, a estrutura lança exceções quando você chama Atualizar.
Adicionando um registro em um conjunto de registros
Você pode adicionar novos registros em um conjunto de registros se sua função de membro de CanAppend retorna um valor diferente de zero.
Para adicionar um novo registro para um conjunto de registros
Verifique se o conjunto de registros é appendable.
Chame a função de membro de AddNew do objeto do conjunto de registros.
AddNew prepara o conjunto de registros para atuar como um buffer de edição. Todos os membros de dados do campo são definidos como zero do valor especial e marcados como sujos de forma que apenas valores () alterados inalteradas são gravados na fonte de dados quando você chama Atualização.
Definir os valores dos membros de dados do campo de registro novo.
Atribuir valores aos membros de dados do campo. As que você não atribuir não são gravados na fonte de dados.
Chame a função de membro de Atualizar do objeto do conjunto de registros.
Atualizar conclui a adição do gravando novo registro à fonte de dados. Para obter informações sobre como acontece se você não chama Atualizar, consulte Conjunto de registros: Como registros de atualização dos conjuntos de registros (ODBC).
Para obter informações sobre como adicionar registra trabalhos e sobre quando os registros adicionados são visíveis no conjunto de registros, consulte Conjunto de registros: Como AddNew, edição e, trabalho de exclusão (ODBC).
O exemplo a seguir mostra como adicionar um novo registro:
if( !rsStudent.Open( ) )
return FALSE;
if( !rsStudent.CanAppend( ) )
return FALSE; // no field values were set
rsStudent.AddNew( );
rsStudent.m_strName = strName;
rsStudent.m_strCity = strCity;
rsStudent.m_strStreet = strStreet;
if( !rsStudent.Update( ) )
{
AfxMessageBox( "Record not added; no field values were set." );
return FALSE;
}
Dica
Para cancelar uma chamada de AddNew ou de Editar , execute apenas outra chamada para AddNew ou a Editar ou chame Mover com o parâmetro de AFX_MOVE_REFRESH .Os membros de dados são redefinidos para os valores anteriores e você ainda estão em Editar ou do modo de Adicionar .
Editando um registro em um conjunto de registros
Você pode editar registros existentes se a função de membro de CanUpdate do conjunto de registros retorna um valor diferente de zero.
Para editar um registro existente em um conjunto de registros
Verifique se o conjunto de registros é atualizável.
Role ao registro que você deseja atualizar.
Chame a função de membro de Edição do objeto do conjunto de registros.
Editar prepara o conjunto de registros para atuar como um buffer de edição. Todos os membros de dados do campo são marcados de modo que o conjunto de registros pode informar posteriormente se foram alterados. Os novos valores para membros de dados alterados do campo são gravados na fonte de dados quando você chama Atualização.
Definir os valores dos membros de dados do campo de registro novo.
Atribuir valores aos membros de dados do campo. As que você não atribuir valores permanecem inalterados.
Chame a função de membro de Atualizar do objeto do conjunto de registros.
Atualizar concluir a edição do gravando registro alterado à fonte de dados. Para obter informações sobre como acontece se você não chama Atualizar, consulte Conjunto de registros: Como registros de atualização dos conjuntos de registros (ODBC).
Depois que você edita um registro, o registro permanece editado o registro atual.
O exemplo a seguir mostra uma operação de Editar . Assumir o usuário movê-lo para um registro ou deseja editar.
rsStudent.Edit( );
rsStudent.m_strStreet = strNewStreet;
rsStudent.m_strCity = strNewCity;
rsStudent.m_strState = strNewState;
rsStudent.m_strPostalCode = strNewPostalCode;
if( !rsStudent.Update( ) )
{
AfxMessageBox( "Record not updated; no field values were set." );
return FALSE;
}
Dica
Para cancelar uma chamada de AddNew ou de Editar , execute apenas outra chamada para AddNew ou a Editar ou chame Mover com o parâmetro de AFX_MOVE_REFRESH .Os membros de dados são redefinidos para os valores anteriores e você ainda estão em Editar ou do modo de Adicionar .
Excluindo um registro de um conjunto de registros
Você pode excluir registros se a função de membro de CanUpdate do conjunto de registros retorna um valor diferente de zero.
Para excluir um registro
Verifique se o conjunto de registros é atualizável.
Role ao registro que você deseja atualizar.
Chame a função de membro de Excluir do objeto do conjunto de registros.
Excluir marca imediatamente o registro como excluído, no conjunto de registros e na fonte de dados.
Ao contrário de AddNew e de Editar, Excluir não tem nenhum chamada correspondente de Atualizar .
Role para outro registro.
Dica
Ao mover com o conjunto de registros, os registros excluídos não podem ser ignorados.Para obter mais informações, veja a função de membro de IsDeleted .
O exemplo a seguir mostra uma operação de Excluir . Assume que o usuário se transportou a um registro que o usuário deseja excluir. Depois que Excluir é chamado, é importante para a movimentação para um novo registro.
rsStudent.Delete( );
rsStudent.MoveNext( );
Para obter mais informações sobre os efeitos de AddNew, Editar, e as funções de membro de Excluir , consulte Conjunto de registros: Como registros de atualização dos conjuntos de registros (ODBC).