віртуальний недійсними AddNew ( );
кинути ( CDBException );
Зауваження
Телефонуйте цієї функції-члена підготувати для додавання нового запису до таблиці. Ви повинні викликати функцію Повторний запит членів, щоб переглянути нещодавно додали запис. Поля запису, спочатку Null. (У термінології бази даних, значення Null означає, що "мають значення не", і не є такою ж, як NULL в C++). Для завершення операції, ви повинні викликати функцію оновлення члена. Оновлення збереже зміни до джерела даних.
Приміткаnbsp; Якщо ви здійснили, отримання рядків навалом, ви не можете зателефонувати Add&New. У результаті буде невдалих твердження. Хоча клас CRecordset не надає механізм для оновлення навалом рядків даних, ви можете написати свій власний функції за допомогою функції ODBC API SQLSetPos. Приклад того, як це зробити, перегляньте зразок DBFETCH. Щоб отримати додаткові відомості про отримання рядків навалом, перегляньте статтю набір записів: вилучення записів у базову (ODBC) в Visual C++ програміста керівництво.
AddNew готує новий, пустий запис за допомогою члени дані полів у наборі записів. Після того, як ви називаєте AddNew, встановити потрібні значення у члени дані полів у наборі записів. (Ви не повинні викликати функцію член редагування для цієї мети; використання Правка тільки для наявних записів.) При подальшому виклику оновлення, змінив значення в поля даних, члени зберігаються на джерелі даних.
Застереження Якщо ви перейдіть до нового запису, перш ніж ви називаєте оновлення, новий запис, буде втрачено, і надається без попередження.
Якщо джерело даних підтримує угоди, ви можете зробити ваш AddNew назвати частиною транзакції. Щоб отримати додаткові відомості про угоди побачити класу CDatabase. Зверніть увагу, що ви повинні назвати CDatabase::BeginTrans перед викликом AddNew.
Важливо Для dynasets додавання нових записів до набір записів як останнього запису. Додавання записів не буде додано до знімків — ви повинні викликати Повторний запит оновити набір записів.
Це незаконно назвати AddNew для набору записів, якого відкритим члена функції не називається. CDBException кинули, якщо назвати AddNew для записів, які не можуть бути включені до. Ви можете визначити, чи набір записів є оновлюваним, зателефонувавши CanAppend.
Для отримання додаткової інформації, такі статті в Visual C++ програміста керівництво: набір записів: як набори записів оновлення записів (ODBC), набір записів: додавання, оновлення та видалення записів (ODBC), і Операції (ODBC).
Приклад
У статті угоди: проведення транзакції набір записів (ODBC) в Visual C++ програміста керівництво.
Огляд CRecordset | Члени класу | Ієрархічна діаграма
Дивіться також CRecordset::Edit, CRecordset::Delete, CRecordset::Update, CRecordset::Requery, CDatabase::BeginTrans, CDBException