CRecordset::AddNew

wirtualne nieważne AddNew ( );
rzut ( CDBException );

Uwagi

Wywołanie tej funkcji Państwa do przygotowania przy dodawaniu nowego rekordu do tabeli. Należy wywołać funkcję Państwa Requery , aby wyświetlić nowo dodanego rekordu. Pola rekordu są początkowo Null. (W terminologii baz danych, Null oznacza "posiadające nie wartość" i nie jest taka sama, jak wartość NULL w języku C++). Do ukończenia tej operacji, należy wywołać funkcję Państwa aktualizacji . Update zapisuje zmiany do źródła danych.

Uwaganbsp;  Jeśli zostaną wdrożone, pobieranie wiersza luzem, nie można wywołać element Add&New. Spowoduje to twierdzenie nie powiodło się. Chociaż klasa CRecordset nie zapewniają mechanizm aktualizacji zbiorczej wierszy danych, można napisać własne funkcje za pomocą funkcji interfejsu API ODBC SQLSetPos. Aby zapoznać się z przykładem tego, jak to zrobić, zobacz próbki DBFETCH. Aby uzyskać więcej informacji na temat pobierania wierszy zbiorczej, zobacz artykuł rekordów: pobieranie rekordów w masowych (ODBC) w Visual C++ Programmer's Guide.

Element AddNew przygotowuje nowy, pusty rekord przy użyciu zestawu rekordów pole danych członków. Po wywołaniu AddNeww wartości, które chcesz w zestawie rekordów pole danych członków. (Nie musisz wywołać funkcję Państwa edycji do tego celu; użyj edytować tylko dla istniejących rekordów.) Po wywołaniu następnie aktualizację, zmianie wartości pola danych, które członkowie są zapisywane w źródle danych.

Przestroga   Jeśli podczas przewijania do nowego rekordu, zanim zadzwonisz aktualizacji, nowy rekord jest tracone, a znajduje się żadne ostrzeżenie.

Jeśli źródło danych obsługuje transakcje, można wprowadzić swój AddNew wywołania częścią transakcji. Aby uzyskać więcej informacji o transakcjach zobacz klasy CDatabase. Należy zauważyć, że powinna wywołać CDatabase::BeginTrans przed wywołaniem AddNew.

Waż&nenbsp;  Dla zestawy dynamiczne nowe rekordy są dodawane do zestawu rekordów jako ostatniego rekordu. Dodane rekordy nie są dodawane do migawek — należy wywołać PonówKwerendę odświeżania rekordów.

Nie jest wywołanie AddNew zestawu rekordów, w których otwarty funkcji członek nie została wywołana. CDBException jest generowany, jeśli wywołanie AddNew zestawu rekordów, które nie mogą być dołączane do. Można określić, czy zestaw rekordów jest aktualizowalna przez wywołanie CanAppend.

Aby uzyskać więcej informacji, zobacz następujące artykuły w Visual C++ Programmer's Guide: rekordów: jak zestawy rekordów aktualizacji rekordów (ODBC), rekordów: dodawanie, aktualizowanie i usuwanie rekordów (ODBC), i Transakcji (ODBC).

Przykład

Zobacz artykuł transakcji: wykonywanie transakcji w zestawie rekordów (ODBC) w Visual C++ Programmer's Guide.

Omówie&nie CRecordset |nbsp; Klasa członków | Wykres hierarchii

Zobacz też CRecordset::Edit, CRecordset::Delete, CRecordset::Update, CRecordset::Requery, CDatabase::BeginTrans, CDBException

Index