CRecordset::Update

Artykuł
02/27/2013

Kończy AddNew lub Edytuj operacji przez zapisanie nowej lub edytowanej danych w źródle danych.

virtual BOOL Update( );

Wartość zwracana

Niezerowa, jeśli jeden rekord został pomyślnie zaktualizowany; inaczej 0 kolumn nie uległy zmianie.Jeśli rekordy nie zostały zaktualizowane lub jeśli więcej niż jeden rekord został zaktualizowany, jest wyjątek.Jest również wyjątek dla innych awarii w źródle danych.

Uwagi

Wywołanie tej funkcji Członkowskich po wywołaniu AddNew lub Edytuj funkcji składowej.To wywołanie jest wymagane do ukończenia AddNew lub Edytuj operacji.

[!UWAGA]

Jeśli zaimplementowano pobieranie wiersza luzem, nie można wywołać Aktualizacja.Spowoduje to potwierdzenia nie powiodło się.Chociaż klasy CRecordset mechanizmu aktualizacji zbiorczej wierszy danych, można napisać własne funkcje za pomocą funkcji interfejsu API ODBC SQLSetPos.Aby uzyskać więcej informacji na temat Pobieranie wiersza luzem, zobacz artykuł rekordów: pobieranie rekordów luzem (ODBC).

Obie AddNew i Edytuj przygotować buforu Edycja, w którym umieszczony jest dodane lub zmodyfikowane dane do zapisania na źródła danych.Aktualizacja zapisuje dane.Aktualizowane są tylko pola oznaczone lub Wykryto zmiany w.

Jeśli źródło danych obsługuje transakcje, można utworzyć aktualizacji call (i odpowiadające jej AddNew lub Edytuj wywołania) część transakcji.Aby uzyskać więcej informacji o transakcjach, zobacz artykuł Transakcji (ODBC).

Przestroga
Jeśli zadzwonisz aktualizacji bez wywoływania AddNew lub Edytuj, aktualizacji wyrzuca CDBException.Jeśli zadzwonisz AddNew lub Edytuj, musi wywołać Aktualizacja przed wywołaniem przenieść operacji lub zamknąć zestaw rekordów lub połączenie źródła danych.W przeciwnym razie zmiany zostaną utracone bez powiadomienia.