virtuel BOOL Mise à jour ( );
jeter ( CDBException );
Valeur de retour
Différent de zéro si un enregistrement a été mis à jour avec succès ; sinon 0 si aucune colonne n'ont changé. Si aucun enregistrement n'ont été mis à jour, ou si plus d'un enregistrement a été mis à jour, une exception est levée. Une exception est également levée pour tout autre échec sur la source de données.
Remarques
Appelez cette fonction membre après un appel à la fonction membre AddNew ou Edit . Cet appel est requis pour terminer l'opération AddNew ou Edit.
&Notenbsp ; Si vous avez implémenté d'extraction de lignes en bloc, vous ne pouvez pas appeler la mise à jour. Cela se traduira par une Échec assertion. Bien que la classe CRecordset ne fournit pas un mécanisme de mise à jour de lignes en bloc de données, vous pouvez écrire vos propres fonctions en utilisant la fonction API ODBC SQLSetPos. Pour obtenir un exemple de comment procéder, consultez l'exemple DBFETCH. Pour plus d'informations sur l'extraction de lignes en bloc, consultez l'article jeu d'enregistrements : extraction de dossiers en vrac (ODBC) dans le Guide du programmeur Visual C++.
Les AddNew et Edit préparent un tampon d'édition dans lequel on met les données ajoutées ou modifiées pour sauver la source de données. Mise à jour , enregistre les données. Ces champs marqués ou détecté comme modifiées sont mises à jour.
Si la source de données prend en charge les transactions, vous pouvez faire l'appel de mise à jour (et ses correspondants AddNew ou Edit appeler) fait partie d'une transaction. Pour plus d'informations sur les transactions, consultez l'article Transaction ((ODBC)) dans le Guide du programmeur Visual C++.
Prudencenbsp ; Si vous appelez Update sans appeler d'abord soit Add&New ou Edit, Update lève une exception CDBException. Si vous appelez AddNew ou Edit, vous devez appeler mise à jour avant de vous appeler une opération de déplacement ou avant de vous fermer soit le jeu d'enregistrements ou de la connexion de source de données. Sinon, vos modifications sont perdues sans notification.
Pour plus de détails sur la gestion des échecs de la mise à jour , consultez l'article jeu d'enregistrements : mise à jour des Jeux d'enregistrements de données (ODBC) dans le Guide du programmeur Visual C++.
Exemple
Consultez l'article Transaction : exécution d'une Transaction dans un jeu d'enregistrements (ODBC) dans le Guide du programmeur Visual C++.
Aperçu de CRecordset | ; Membres de la classe | Graphique de la hiérarchie
Voir aussinbsp ;CRecordset::Edit, CRecordset::Add&New, CRecordset::SetFieldDirty, CDBException