CDaoRecordset::AddNew

(wirtualny nieważne AddNew);
rzut (CDaoException, CMemoryException);

Uwagi

Wywołanie tej funkcji członek dodawania nowego rekordu do tabeli typu lub dynamicznego zestawu rekordów. 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.

Przestroga   Jeśli edytowania rekordu, a następnie przewiń do innego rekordu bez wywoływania aktualizacji, zmiany zostaną utracone bez ostrzeżenia.

Po dodaniu rekordu do dynamicznego zestawu rekordów, wywołując AddNewrekord jest widoczna w zestawie rekordów i uwzględnione w tabeli podstawowej, gdzie staje się widoczna dla wszelkich nowych obiektów CDaoRecordset.

Położenie nowego rekordu zależy od typu zestawu rekordów:

Rekord, który był bieżącego, przed użyciem AddNew pozostaje bieżącym. Jeśli chcesz utworzyć nowy rekord bieżący zestaw rekordów obsługuje zakładki, wywołanie SetBookmark zakładki określone przez ustawienie właściwości LastModified obiektu źródłowego zestawu rekordów DAO. Czyniąc jest przydatny do wyznaczania wartości dla pól liczników (automatycznego przyrostu) dodanego rekordu. Aby uzyskać więcej informacji zobacz GetLastModifiedBookmark.

Jeśli baza danych obsługuje transakcje, można wprowadzać użytkownika AddNew wywołania częścią transakcji. Aby uzyskać więcej informacji o transakcjach zobacz klasy CDaoWorkspace. Należy zauważyć, że powinna wywołać CDaoWorkspace::BeginTrans przed wywołaniem AddNew.

Nie jest wywołanie AddNew zestawu rekordów, w których otwarty funkcji członek nie została wywołana. CDaoException jest generowany, jeśli wywołanie AddNew zestawu rekordów, który nie może zostać dołączona. Można określić, czy zestaw rekordów jest aktualizowalna przez wywołanie CanAppend.

Znaki ramy zmianie pola danych członków do zapewnienia, że zostaną one zapisane do rekordu w źródle danych przez mechanizm wymiany (DFX) w polu rekordu DAO. Zmiana wartości pola ogólnie ustawia pole dirty automatycznie, tak rzadko będzie musiał dzwonić SetFieldDirty samodzielnie, ale czasami może wystąpić potrzeba zapewnienia, że kolumny będzie się wyraźnie zaktualizowane lub wstawione niezależnie od tego jakie wartość w polu Członek danych. Mechanizm DFX wykorzystuje również użycie PSEUDO NULL. Aby uzyskać więcej informacji zobacz CDaoFieldExchange::m_nOperation.

Jeśli mechanizm podwójne buforowanie nie jest używany, następnie zmiana wartości tego pola nie automatycznie Ustaw pole jako zanieczyszczony. W tym przypadku będzie konieczne do zestawu wyraźnie określone w polu zanieczyszczony. Flaga zawarte w formantach m_bCheckCacheForDirtyFields to pole automatyczne sprawdzanie.

Uwaganbsp;  Jeśli rekordy są buforowane double (oznacza to, że pole automatyczne sprawdzanie jest włączone), wywołanie CancelUpdate przywróci zmienne składowe wartości mieli przed Add&New lub Edycja została wywołana.

Aby uzyskać więcej informacji na temat aktualizowania rekordów, zobacz artykuł zestawu rekordów DAO: zestaw rekordów operacji w Visual C++ Programmer's Guide. Aby uzyskać pokrewne informacje zobacz tematy „metoda AddNew","Metoda CancelUpdate","Właściwość LastModified"i"EditMode właściwości"w pomocy programu DAO.

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

Zobacz też CDaoRecordset::CanUpdate, CDaoRecordset::CancelUpdate, CDaoRecordset::Delete, CDaoRecordset::Edit, CDaoRecordset::Update, CDaoRecordset::CanTransact

Index