CDaoDatabase::executar

Artigo
08/25/2010

Chame essa função de membro para executar uma consulta ação ou executar uma demonstrativo SQL no banco de dados.

void Execute( 
   LPCTSTR lpszSQL, 
   int nOptions = dbFailOnError  
);

Parâmetros

lpszSQL
Ponteiro para uma cadeia terminada com nulo que contém o comando SQL válido a ser executado.
nOptions
Um número inteiro que especifica as opções relacionadas à integridade da consulta.Você pode usar o operador OR bit a bit (|) para agrupar qualquer uma das seguintes constantes (desde que a combinação faz sentido — por exemplo, você não poderia agrupar dbInconsistent with dbConsistent):
- dbDenyWrite Negar permissão de gravar a outros usuários.
- dbInconsistent (Padrão) Atualizações divergente.
- dbConsistent Atualizações consistentes.
- dbSQLPassThrough Passagem SQL.Faz com que o demonstrativo SQL ser passados para uma fonte de dados ODBC para processamento.
- dbFailOnError Reverta atualizações se ocorrer um erro.
- dbSeeChanges Gera um erro em time de execução se outro usuário está mudando a dados que você está editando.

Observação:
Se ambos os dbInconsistent and dbConsistent são incluídos ou se nenhuma for incluída, o resultado é o padrão.Para obter uma explicação das constantes, consulte o tópico "Executar o método" na Ajuda do DAO.

Comentários

Executar funciona somente para consultas de ação ou as consultas de passagem SQL que não retornam os resultados.Ele não funciona para consultas seleção, o que retornar registros.

Para obter uma definição e informações sobre consultas ação, consulte os tópicos "consulta ação" e "Executar o método" na Ajuda do DAO.

Dica:
Devido a uma demonstrativo SQL sintaticamente correta e as permissões adequadas, o Executarfunção de membro não falhará mesmo se uma única linha não pode ser modificada ou excluída.Portanto, sempre use o dbFailOnError opção ao usar o Executar função de membro para executar uma atualização ou consulta de excluir.Essa opção faz com que a MFC lançar uma exceção do tipo CDaoException e rolos bem-sucedidas todas as alterações de volta se todos os registros afetados são bloqueados e não podem ser atualizados ou excluídos.Observe que você sempre pode chamar GetRecordsAffected Para ver quantos registros foram afetados.

Devido a uma demonstrativo SQL sintaticamente correta e as permissões adequadas, o Executarfunção de membro não falhará mesmo se uma única linha não pode ser modificada ou excluída.Portanto, sempre use o dbFailOnError opção ao usar o Executar função de membro para executar uma atualização ou consulta de excluir.Essa opção faz com que a MFC lançar uma exceção do tipo CDaoException e rolos bem-sucedidas todas as alterações de volta se todos os registros afetados são bloqueados e não podem ser atualizados ou excluídos.Observe que você sempre pode chamar GetRecordsAffected Para ver quantos registros foram afetados.

Chamar o GetRecordsAffected função de membro do objeto de banco de dados para determinar o número de registros afetados pelo mais recente Executar telefonar.Por exemplo, GetRecordsAffected Retorna informações sobre o número de registros excluídos, atualizado ou inserido durante a execução de uma consulta ação. A contagem retornada não refletirá as alterações em tabelas relacionadas quando cascata atualiza ou exclui estão em vigor.

Executar não retorna um conjunto de registros.Usando Executar em uma consulta que seleciona registros faz com que a MFC lançar uma exceção do tipo CDaoException. (Não há nenhum ExecuteSQL função de membro análoga ao CDatabase::ExecuteSQL.)