CRecordset::AddNew

Статья
02/20/2013

Подготавливает для добавления новой записи в таблицу.

virtual void AddNew( );

Заметки

Необходимо вызвать функцию-член Requery, чтобы увидеть вновь добавленную запись.Поля записи исходного значения null.(В терминологии базы данных, null означает "не имеет значения" и не совпадает с NULL в C++). Для выполнения этой операции необходимо вызвать функцию-член обновление.Обновить сохраняет изменения в источнике данных.

Примечание
Если реализован bulk строку выборку, то нельзя вызывать AddNew.Это приведет к становятся утверждении.Хотя класс CRecordset не предоставляет механизм для обновления массовые строки данных, можно написать собственные функции с помощью api-функций ODBC SQLSetPos.Дополнительные сведения о массовой строке выборке см. в статье Набор записей. Пакетная выборка строк (ODBC).

Если реализован bulk строку выборку, то нельзя вызывать AddNew.Это приведет к становятся утверждении.Хотя класс CRecordset не предоставляет механизм для обновления массовые строки данных, можно написать собственные функции с помощью api-функций ODBC SQLSetPos.Дополнительные сведения о массовой строке выборке см. в статье Набор записей. Пакетная выборка строк (ODBC).

AddNew подготавливает новую пустую запись с использованием элементов данных полей в наборе записей.После вызова AddNew задайте значения в элементах данных полей в наборе записей.(Не следует вызвать функцию-член правка для этой цели; используйте Изменить только для существующих записей). При нажатии далее вызовите Обновить, измененные значения в элементах данных полей сохранены в источнике данных.

Внимание
Если перейдите к новому рекорду, прежде чем вызывать метод Обновить, новая запись потерян, предупреждение не предоставляется.

Если источник данных поддерживает транзакции, то можно сделать свою часть вызова AddNew транзакции.Дополнительные сведения о транзакциях см. в описании класса CDatabase.Обратите внимание, что необходимо вызывать перед вызовом CDatabase::BeginTransAddNew.

Примечание
Для динамических подмножеств данных, новые записи добавлены к набору записей в качестве последней записи.Добавленные записи не добавлены к моментальным снимкам; необходимо вызвать Requery для обновления набора записей.

Для динамических подмножеств данных, новые записи добавлены к набору записей в качестве последней записи.Добавленные записи не добавлены к моментальным снимкам; необходимо вызвать Requery для обновления набора записей.

Недопустимо вызывать AddNew для набора записей функции-члена Открыть которого не был вызван.CDBException возникающее, если вызывается AddNew набора записей, который не может быть добавлено.Можно указать быть обновляемым, является ли набор записей путем вызова CanAppend.

Дополнительные сведения см. в следующих статьях: Набор записей. Порядок обновления записей в наборе (ODBC), Набор записей. Добавление, обновление и удаление записей (ODBC) и транзакция (ODBC).