Udostępnij za pośrednictwem


CRecordset::Update

 

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

Składnia

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).  

Ostrzeżenie

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.  

Szczegółowe informacje na temat obsługi Aktualizacja awarii, zobacz artykuł rekordów: jak zestawy rekordów aktualizacji rekordów (ODBC).

Wyjątki

Exception

Condition

Tej metody można zgłosić wyjątków typu CDBException *.

Przykład

Zobacz artykuł transakcji: wykonywanie transakcji w zestawie rekordów (ODBC).

Wymagania

Nagłówek: afxdb.h

Zobacz też

Klasa CRecordset
Diagram hierarchii
CRecordset::Edit
CRecordset::AddNew
CRecordset::SetFieldDirty
Klasa CDBException