CDaoDatabase::Execute

void Execute (LPCTSTR lpszSQL, int nOptions = 0);
lançar (CDaoException, CMemoryException);

Parâmetros

lpszSQL

Ponteiro para uma seqüência de caracteres null-terminated que contém um comando SQL válido para executar.

nOptions

Um integer que especifica as opções relacionadas à integridade da consulta. Você pode usar o operador bit a bit ou (|) para combinar qualquer uma das seguintes constantes (desde que a combinação faz sentido — por exemplo, você não iria combinar dbInconsistent com dbConsistent):

&Notanbsp;  Se ambos os dbInconsistent e dbConsistent estão incluídos ou se não for incluído, o resultado é o padrão. Para obter uma explicação das constantes, consulte o tópico "Método executar" na Ajuda do DAO.

Observações

Chame essa função de membro para executar uma consulta ação ou executar uma instrução SQL no banco de dados. Executar funciona somente para consultas de ação ou consultas passagem SQL que não retornam resultados. Ele não funciona para consultas select, que retornam registros.

Para uma definição e informações sobre consultas ação, consulte os tópicos "Consulta de ação" e "Método executar" na Ajuda do DAO.

Dica   Dada uma instrução SQL sintaticamente correta e permissões adequadas, a função de membro executar não falhará mesmo se não uma única linha pode ser modificada ou excluída. Portanto, sempre use a opção de dbFailOnError ao usar a função de membro executar para executar uma atualização ou consulta de exclusão. Esta opção faz com que MFC lançar uma exceção do tipo CDaoException e reverte todas as alterações bem-sucedidas se qualquer um dos registros afetados estão bloqueados e não pode ser atualizado ou excluído. Anotação que você sempre pode chamar GetRecordsAffected para ver quantos registros foram afetados.

Chame a função de membro GetRecordsAffected do objeto de banco de dados para determinar o número de registros afetados pela chamada de execução mais recente. Por exemplo, GetRecordsAffected retorna informações sobre o número de registros excluídos, atualizados ou inseridos ao executar uma consulta ação. A contar retornada não refletirá as alterações nas tabelas relacionadas quando em cascata atualiza ou exclui estão em vigor.

Executar não retornar um conjunto de registros. Usar Execute em uma consulta que seleciona registros causas MFC lançar uma exceção do tipo CDaoException. (Não há nenhuma função de membro ExecuteSQL parecido com CDatabase:: ExecuteSQL.)

Para obter mais informações sobre como usar a função de membro executar , consulte o artigo DAO definiçãodeconsulta: Querydefs usando no Guia do programador do Visual C++.

Visão geral de CDaoDatabaseMembros de classe | Gráfico de hierarquia

Index