Класс CDaoRecordset

Статья
06/10/2015

Представляет набор записей, выбранных из источника данных.

class CDaoRecordset : public CObject

Члены

Открытые конструкторы

Имя	Описание
CDaoRecordset::CDaoRecordset	Создает объект CDaoRecordset.

Открытые методы

Имя	Описание
CDaoRecordset::AddNew	Подготавливает для добавления новой записи. Вызов обновление для выполнения сложения.
CDaoRecordset::CanAppend	Возвращает ненулевое значение, если новых записей можно добавить к набору записей посредством функции-члена AddNew.
CDaoRecordset::CanBookmark	Возвращает ненулевое значение, если набор записей поддерживает закладки.
CDaoRecordset::CancelUpdate	Отменяет все ожидающие обновления из-за правка или операции AddNew.
CDaoRecordset::CanRestart	Возвращает ненулевое значение, если Requery можно вызывать для выполнения запроса набора записей.
CDaoRecordset::CanScroll	Возвращает ненулевое значение, если можно прокручивать записи.
CDaoRecordset::CanTransact	Возвращает ненулевое значение, если источник данных поддерживает транзакции.
CDaoRecordset::CanUpdate	Возвращает ненулевое значение, если набор записей можно обновить (можно добавлять, обновлять или удалять записи).
CDaoRecordset::Close	Закрывает набор записей.
CDaoRecordset::Delete	Удаляет текущую запись набора записей. Необходимо явно выполнить прокрутку к другой записи после удаления.
CDaoRecordset::DoFieldExchange	Вызываемый для обмена данными (в обоих направлениях) между элементами данных полей набора записей и соответствующие записи в источнике данных. Обмен полями записей DAO инструментов (DFX).
CDaoRecordset::Edit	Подготавливает для изменения текущей записи. Вызов Обновить для завершает правку.
CDaoRecordset::FillCache	Заполняет все или часть локального кэша для объекта набора записей, содержащий данные из источника данных ODBC.
CDaoRecordset::Find	Находит во-первых, следующий, более ранней, либо последнее расположение указанной строки в наборе записей является динамическим подмножеством данных- типа, удовлетворяющий указанному условию, и делает, который записывает текущую запись.
CDaoRecordset::FindFirst	Находит первую запись в наборе записей является динамическим подмножеством данных- типа или моментальный снимок- типа, удовлетворяющий указанному условию, и делает, которое записывает текущую запись.
CDaoRecordset::FindLast	Находит последней записи в наборе записей является динамическим подмножеством данных- типа или моментальный снимок- типа, удовлетворяющий указанному условию, и делает, которое записывает текущую запись.
CDaoRecordset::FindNext	Найдите следующую запись в наборе записей является динамическим подмножеством данных- типа или моментальный снимок- типа, удовлетворяющий указанному условию, и делает, которое записывает текущую запись.
CDaoRecordset::FindPrev	Найдите предыдущие записи в наборе записей является динамическим подмножеством данных- типа или моментальный снимок- типа, удовлетворяющий указанному условию, и делает, которое записывает текущую запись.
CDaoRecordset::GetAbsolutePosition	Возвращает номер записи текущей записи объекта набора записей.
CDaoRecordset::GetBookmark	Возвращает значение, которое представляет закладку для записи.
CDaoRecordset::GetCacheSize	Возвращает значение, указывающее количество записей в наборе записей является динамическим подмножеством данных- типа, содержащего данные локально, которые необходимо кэшировать из источника данных ODBC.
CDaoRecordset::GetCacheStart	Возвращает значение, определяющее закладку первой записи в наборе записей, который необходимо кэшировать.
CDaoRecordset::GetCurrentIndex	Возвращает CString, содержащий имя индекса последнего использовавшего ся для индексирования, табличного типа CDaoRecordset.
CDaoRecordset::GetDateCreated	Возвращает дату и время создана базовая таблица была лежащие в основе CDaoRecordset объект
CDaoRecordset::GetDateLastUpdated	Возвращает дату и время самого последнего выполненного изменения в структуре базовой таблицы, лежащие в основе CDaoRecordset объект.
CDaoRecordset::GetDefaultDBName	Возвращает имя по умолчанию источника данных.
CDaoRecordset::GetDefaultSQL	Вызываемый для получения по умолчанию строку выполнить SQL.
CDaoRecordset::GetEditMode	Возвращает значение, указывающее состояние изменения для текущей записи.
CDaoRecordset::GetFieldCount	Возвращает значение, представляющее число полей в наборе записей.
CDaoRecordset::GetFieldInfo	Возвращает сведения о конкретных типов полей в наборе записей.
CDaoRecordset::GetFieldValue	Возвращает значение поля в наборе записей.
CDaoRecordset::GetIndexCount	Получает количество индексов в таблице, лежащие в основе набора записей.
CDaoRecordset::GetIndexInfo	Возвращает различные типы сведений об индексе.
CDaoRecordset::GetLastModifiedBookmark	Используемый, чтобы определить последнее добавления или обновления записи.
CDaoRecordset::GetLockingMode	Возвращает значение, указывающее, что тип блокировать то в силе во время редактирования.
CDaoRecordset::GetName	Возвращает CString, содержащий имя набора записей.
CDaoRecordset::GetParamValue	Возвращает текущее значение указанного параметра, хранящиеся в базовом объекте DAOParameter.
CDaoRecordset::GetPercentPosition	Возвращает позицию текущей записи в процентах общее количество записей.
CDaoRecordset::GetRecordCount	Возвращает число записей, доступ к которым получен в объекте набора записей.
CDaoRecordset::GetSQL	Получает строку SQL, используемый для выбора записей в наборе записей.
CDaoRecordset::GetType	Вызываемый для указания типа набора записей. табличный тип, динамическое подмножество данных-тип или моментальный снимок-тип.
CDaoRecordset::GetValidationRule	Возвращает CString, содержащий значение, которое проверяет данные по мере того, как они введены в поле.
CDaoRecordset::GetValidationText	Извлекает текст, отображаемый, если правило проверки не выполняется.
CDaoRecordset::IsBOF	Возвращает ненулевое значение, если был расположен набор записей перед первой записью. Отсутствует текущая запись.
CDaoRecordset::IsDeleted	Возвращает ненулевое значение, если набор записей располагается на удалянную запись.
CDaoRecordset::IsEOF	Возвращает ненулевое значение, если набор записей был расположен после последней записи. Отсутствует текущая запись.
CDaoRecordset::IsFieldDirty	Возвращает ненулевое значение, если было изменен указанное поле в текущей записи.
CDaoRecordset::IsFieldNull	Возвращает ненулевое значение, если указанное поле в текущей записи равен null (не имеющий значение).
CDaoRecordset::IsFieldNullable	Возвращает ненулевое значение, если указанное поле в текущей записи можно задать значение null (не имеющий значение).
CDaoRecordset::IsOpen	Возвращает ненулевое значение, если Открытие было ранее вызываются.
CDaoRecordset::Move	Располагает набор записей с заданным количеством записей из текущей записи в любом направлении.
CDaoRecordset::MoveFirst	Располагает текущую запись в первую запись в наборе записей.
CDaoRecordset::MoveLast	Располагает текущую запись на последнюю запись в наборе записей.
CDaoRecordset::MoveNext	Располагает текущую запись в следующую запись в наборе записей.
CDaoRecordset::MovePrev	Располагает текущую запись на предыдущую запись в наборе записей.
CDaoRecordset::Open	Создает новый набор записей из таблицы динамического подмножества данных или моментального снимка.
CDaoRecordset::Requery	Запускает запрос набора записей, чтобы обновить выбранные записи.
CDaoRecordset::Seek	Найдите запись в индексированном объекте набора записей пользователем табличного типа, удовлетворяющий указанному условию для текущего индекса и делает, которое записывает текущую запись.
CDaoRecordset::SetAbsolutePosition	Задает номер записи текущей записи объекта набора записей.
CDaoRecordset::SetBookmark	Располагает набор записей на запись, содержащий указанную закладку.
CDaoRecordset::SetCacheSize	Задает значение, указывающее количество записей в наборе записей является динамическим подмножеством данных- типа, содержащего данные локально, которые необходимо кэшировать из источника данных ODBC.
CDaoRecordset::SetCacheStart	Устанавливает значение, определяющее закладку первой записи в наборе записей, который необходимо кэшировать.
CDaoRecordset::SetCurrentIndex	Вызываемый для задания индексов в наборе записей пользователем табличный тип.
CDaoRecordset::SetFieldDirty	Помечает указанное поле в текущей записи изменен.
CDaoRecordset::SetFieldNull	Задает значение указанного поля в текущей записи к null (не имеющий значение).
CDaoRecordset::SetFieldValue	Задает значение поля в наборе записей.
CDaoRecordset::SetFieldValueNull	Задает значение поля в наборе записей значение null. (не имеющий значение).
CDaoRecordset::SetLockingMode	Задает значение, которое указывает тип блокирования, который необходимо запускать во время редактирования.
CDaoRecordset::SetParamValue	Устанавливает текущее значение указанного параметра, хранящиеся в базовом объекте DAOParameter
CDaoRecordset::SetParamValueNull	Устанавливает текущее значение заданного параметра значение null (не имеющий значение).
CDaoRecordset::SetPercentPosition	Задает позицию текущей записи к расположению, соответствующая доля общему количеству записей в наборе записей.
CDaoRecordset::Update	Выполняет операцию AddNew или Изменить путем сохранения новых или отредактированные данных в источнике данных.

Открытые члены данных

Имя	Описание
CDaoRecordset::m_bCheckCacheForDirtyFields	Содержит пометить указывающее, следует ли автоматически помечаются как изменен поля.
CDaoRecordset::m_nFields	Содержит число элементов данных полей в классе набора записей и число столбцов, выбранных набором записей из источника данных.
CDaoRecordset::m_nParams	Содержит число элементов данных параметров в классе набора записей — количество параметров, передаваемых с запросом набора записей
CDaoRecordset::m_pDAORecordset	Указатель на интерфейс DAO, лежащие в основе объекта набора записей.
CDaoRecordset::m_pDatabase	База данных-источник для этого результирующего набора. Содержит указатель на объект CDaoDatabase.
CDaoRecordset::m_strFilter	Содержит строку, используемую для построения выписку WHERE SQL.
CDaoRecordset::m_strSort	Содержит строку, используемую для построения выписку ORDER BY SQL.

Заметки

Наборы записей" как "объекты CDaoRecordset доступны в следующих форм: 3

Наборы записей пользователем табличные типы представляют собой базовую таблицу, которую можно использовать для просмотра, добавления, изменения или удаления записей из одной таблицы базы данных.
Наборы записей является динамическим подмножеством данных- типа результата запроса, который может иметь обновляемые записи. Эти наборы записей набор записей, которые можно использовать для просмотра, добавления, изменения или удаления записей из базовой таблицы или таблиц базы данных. Наборы записей является динамическим подмножеством данных- типа могут содержать поля из одной или нескольких таблиц в базе данных.
Наборы записей является моментальным снимок- типа статическая копия набора записей, которые можно использовать для поиска данных или создавать отчеты. Эти наборы записей могут содержать поля из одной или нескольких таблиц в базе данных, но не могут быть обновлены.

Каждая форма набора записей представляет набор записей в момент исправленных набор записей открыт. При прокрутке к записи в наборе записей пользователем табличный тип или набор записей является динамическим подмножеством данных- типа, отражает изменения, внесенные в записи после набора записей открыт или другими пользователями или другими наборами записей в приложении. (Набор записей является моментальным снимок- типа a не может быть обновлен). Можно использовать CDaoRecordset напрямую или наследование относящийся к приложению класс набора записей из CDaoRecordset. Можно выполнить следующее.

Прокрутка по записям.
Задайте индекс и быстрый поиск с использованием поиск (наборы записей пользователем табличный тип).
Поиск записей на основе сравнения строк: "<", "<=", "=", ">=" или ">" (наборы записей является динамическим подмножеством данных- типа и моментальный снимок- типа).
Обновление записи и укажите блокируя режим (за исключением наборов записей является моментальным снимок- типа).
Отфильтровать набор записей, чтобы ограничить записи, оно выберите пункт из доступных в источнике данных.
Сортирует набор записей.
Параметризация набора записей не будет настраивать его выделение со сведениями не известное до времени выполнения.

Предоставляет интерфейс классифицируйте CDaoRecordset подобно этому из класса CRecordset. Основное отличие состоит в том, что данные доступа CDaoRecordset класса через объект доступа к данным (DAO) на основе OLE. Класс CRecordset обращается к engine через ODBC (ODBC) и драйвер ODBC engine.

Примечание

Классы баз данных DAO MFC отличаются от классов баз данных на основе ODBC (ODBC).Все имена классов базы данных DAO имеют префикс "CDao".Можно получить доступ к источнику данных ODBC с помощью классов DAO; классы DAO обычно обеспечивают основные возможности, поскольку они относятся к ядру СУБД jet (Майкрософт).

Можно либо использовать CDaoRecordset напрямую или создания производного класса от CDaoRecordset. Использование класса набора записей в любом случае, открыв базу данных и построения объекта набора записей передачи конструктором указатель на объект CDaoDatabase. Можно также создать объект CDaoRecordset MFC и позволить создать временный объект CDaoDatabase. Затем вызовите функцию-член Открытие набора записей, указывающий, должен ли объект набора записей пользователем табличного типа, набор записей является динамическим подмножеством данных- типа или набор записей является моментальным снимок- типа. Вызов Открыть выбирает и извлекает данные из базы данных первая запись.

Использование функций-членов и элементы данных объекта для прокрутки по записям и приводитесь для них. В зависимости от операций доступно ли объект набора записей пользователем табличного типа, набор записей является динамическим подмножеством данных- типа или набор записей является моментальным снимок- типа и ли он, допускающие обновление или только для чтения " — это зависит от возможностей базы данных или источника данных ODBC (ODBC). Обновление записи, которые могут быть изменены или добавлены поскольку вызов Открыть, вызывает функцию-член Requery объекта. Вызовите функцию-член объекта Закрыть и уничтожение объекта после завершения с ним.

Обмен полями записей DAO польз CDaoRecordset (DFX) для поддержки чтение и обновление записи полей посредством типобезопасные элементов C++ для CDaoRecordset или CDaoRecordset- производного класса. Также можно реализовать динамическую привязку столбцов в базе данных без использования механизма DFX с помощью GetFieldValue и SetFieldValue.

Дополнительные сведения см. в разделе "объект набора записей" в Справке DAO.