CRecordset::AddNew

Artykuł
02/27/2013

Przygotowuje się do dodawania nowego rekordu do tabeli.

virtual void AddNew( );

Uwagi

Musisz wywołać Requery Członkowskich funkcji wyświetlić nowo dodany rekord.Rekordów są początkowo Null.(W terminologii baz danych Null oznacza "posiadające wartość nie" i nie jest taki sam, jak NULL w języku C++.) Aby wykonać operację, należy wywołać Aktualizacja funkcji składowej.Aktualizacja zapisuje zmiany w źródle danych.

[!UWAGA]

Jeśli zaimplementowano pobieranie wiersza luzem, nie można wywołać AddNew.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).

AddNewprzygotowuje nowy, pusty rekord przy użyciu rekordów pole danych członków.Po wywołaniu AddNew, ustaw wartości mają rekordów pole danych członków.(Nie trzeba wywołać Edytuj Członkowskich funkcji w tym celu; Użyj Edytuj tylko dla istniejących rekordów.) Następnie wywołaniu Aktualizacja, zmienione wartości w pola danych członków są zapisywane w źródle danych.

Przestroga
Jeśli podczas przewijania do nowego rekordu przed wywołaniem Aktualizacja, nowy rekord jest utracone i znajduje się żadne ostrzeżenie.

Jeśli źródło danych obsługuje transakcje, można ustawić na AddNew wywołania częścią transakcji.Aby uzyskać więcej informacji dotyczących transakcji, zobacz klasy CDatabase.Należy zauważyć, że należy wywołać CDatabase::BeginTrans przed wywoływaniem AddNew.

[!UWAGA]

Zestawy dynamiczne nowe rekordy są dodawane do zestawu rekordów jako ostatni rekord.Dodane rekordy nie są dodawane do migawek; Musisz wywołać Requery do odświeżania rekordów.

Niedozwolone wywołanie jest AddNew zestawu rekordów którego Otwórz Członkowskich funkcja nie została wywołana.A CDBException jest generowany, jeśli AddNew dla zestawu rekordów, która nie może być dołączona.Można określić, czy zestaw rekordów jest aktualizowalny, wywołując CanAppend.

Aby uzyskać więcej informacji, zobacz następujące artykuły: rekordów: jak zestawy rekordów aktualizacji rekordów (ODBC), rekordów: Dodawanie, aktualizowanie i usuwanie rekordów (ODBC), i Transakcji (ODBC).