CDaoDatabase::Execute

void Execute (LPCTSTR lpszSQL, int nOptions = 0);
jeter (CDaoException, CMemoryException) ;

Paramètres

lpszSQL

Pointeur vers une chaîne terminée par null contenant une commande SQL valide pour exécuter.

nOptions

Un entier qui spécifie des options relatives à l'intégrité de la requête. Vous pouvez utiliser l'opérateur de bits OR (|) pour combiner les constantes suivantes (pourvu que la combinaison logique — par exemple, vous n'aurait pas combiner dbInconsistent avec dbConsistent):

&Notenbsp ;  Si dbInconsistent et dbConsistent sont inclus ou si aucun n'est inclus, le résultat est la valeur par défaut. Pour une explication de ces constantes, consultez la rubrique « Méthode Execute » dans l'aide de DAO.

Remarques

Appelez cette fonction membre pour exécuter une requête action ou exécuter une instruction SQL sur la base de données. Execute ne fonctionne que pour les requêtes d'action ou de requêtes SQL directes SQL qui ne retournent pas de résultats. Il ne fonctionne pas pour les requêtes select qui retournent des enregistrements.

Pour une définition et des informations sur les requêtes action, consultez les rubriques « Requête » et « Méthode Execute » dans l'aide de DAO.

Astucenbsp ;  Étant donné un énoncé syntaxiquement correct de SQL et les autorisations appropriées, la fonction de membre Execute ne manquera pas même si pas une seule ligne peut être modifiée ou supprimée. Par conséquent, utilisez toujours l'option dbFailOnError lors de l'utilisation de la fonction membre Execute pour exécuter une mise à jour ou supprimer des requêtes. Cette option provoque la MFC lever une exception de type CDaoException et annule toutes les modifications de succès si les enregistrements affectés sont verrouillés et ne peut pas être mise à jour ou supprimés. &Notez que vous pouvez toujours appeler GetRecordsAffected pour voir combien d'enregistrements ont été affectés.

Appelez la fonction membre GetRecordsAffected de l'objet de base de données pour déterminer le nombre d'enregistrements affectés par l'appel de Execute plus récent. Par exemple, GetRecordsAffected renvoie des informations sur le nombre d'enregistrements supprimés, mis à jour ou insérée lors de l'exécution d'une requête action. Le comte revient ne reflétera pas les modifications dans les tables connexes lorsque cascade met à jour ou supprime sont en effet.

Execute ne retourne pas un jeu d'enregistrements. À l'aide de Execute sur une requête qui sélectionne les dossiers provoque des MFC lever une exception de type CDaoException. (Il n'aucune fonction de membre ExecuteSQL analogue à CDatabase::ExecuteSQL.)

Pour plus d'informations sur l'utilisation de la fonction membre Execute , consultez l'article Querydef DAO : utilisation des Querydefs dans le Guide du programmeur Visual C++.

Aperçu CDaoDatabase |  ; Membres de la classe | Graphique de la hiérarchie

Index