Класс CRecordset

Статья
06/10/2015

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

class CRecordset : public CObject

Члены

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

Имя	Описание
CRecordset::CRecordset	Создает объект CRecordset. Производный класс должен предоставлять конструктор, который вызывает это одно.

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

Имя	Описание
CRecordset::AddNew	Подготавливает для добавления новой записи. Вызов Update для выполнения сложения.
CRecordset::CanAppend	Возвращает ненулевое значение, если новых записей можно добавить к набору записей посредством функции-члена AddNew.
CRecordset::CanBookmark	Возвращает ненулевое значение, если набор записей поддерживает закладки.
CRecordset::Cancel	Отменяет асинхронную операцию или процесс из второго потока.
CRecordset::CancelUpdate	Отменяет все ожидающие операции обновления из-за AddNew или Edit.
CRecordset::CanRestart	Возвращает ненулевое значение, если Requery можно вызывать для выполнения запроса набора записей.
CRecordset::CanScroll	Возвращает ненулевое значение, если можно прокручивать записи.
CRecordset::CanTransact	Возвращает ненулевое значение, если источник данных поддерживает транзакции.
CRecordset::CanUpdate	Возвращает ненулевое значение, если набор записей можно обновить (можно добавлять, обновлять или удалять записи).
CRecordset::CheckRowsetError	Вызываемый для обработки ошибок, созданные во время записи выборка.
CRecordset::Close	Закрывает набор записей и ODBC HSTMT связанное с ним.
CRecordset::Delete	Удаляет текущую запись набора записей. Необходимо явно выполнить прокрутку к другой записи после удаления.
CRecordset::DoBulkFieldExchange	Вызываемый для обмена массовые строки данных из источника данных в набор записей. Обмен полями записей bulk инструментов (bulk RFX).
CRecordset::DoFieldExchange	Вызываемый для обмена данными (в обоих направлениях) между элементами данных полей набора записей и соответствующие записи в источнике данных. Средства записывают обмен полями записей (RFX).
CRecordset::Edit	Подготавливает для изменения текущей записи. Вызов Update для завершает правку.
CRecordset::FlushResultSet	Возвращает ненулевое значение, если другой результирующий набор, которые необходимо получить, то при использовании предопределенного запроса.
CRecordset::GetBookmark	Присвоить значение закладки записи к объекту параметра.
CRecordset::GetDefaultConnect	Вызываемый для получения строка подключения по умолчанию.
CRecordset::GetDefaultSQL	Вызываемый для получения по умолчанию строку выполнить SQL.
CRecordset::GetFieldValue	Возвращает значение поля в наборе записей.
CRecordset::GetODBCFieldCount	Возвращает количество полей в наборе записей.
CRecordset::GetODBCFieldInfo	Возвращает сведения о конкретных типов полей в наборе записей.
CRecordset::GetRecordCount	Возвращает число записей в наборе записей.
CRecordset::GetRowsetSize	Возвращает число записей необходимо получить во время одного выборки.
CRecordset::GetRowsFetched	Получает фактическое число строк, которые получены во время выборки.
CRecordset::GetRowStatus	Возвращает состояние строки после выборки.
CRecordset::GetSQL	Получает строку SQL, используемый для выбора записей в наборе записей.
CRecordset::GetStatus	Возвращает состояние набора записей. индекс текущей записи и, был ли получен конечный количество записей.
CRecordset::GetTableName	Получает имя таблицы, для которой основан этот набор записей.
CRecordset::IsBOF	Возвращает ненулевое значение, если был расположен набор записей перед первой записью. Отсутствует текущая запись.
CRecordset::IsDeleted	Возвращает ненулевое значение, если набор записей располагается на удалянную запись.
CRecordset::IsEOF	Возвращает ненулевое значение, если набор записей был расположен после последней записи. Отсутствует текущая запись.
CRecordset::IsFieldDirty	Возвращает ненулевое значение, если было изменен указанное поле в текущей записи.
CRecordset::IsFieldNull	Возвращает ненулевое значение, если указанное поле в текущей записи null, то значение (нет).
CRecordset::IsFieldNullable	Возвращает ненулевое значение, если указанное поле в текущей записи можно задать значение null (не имеющий значение).
CRecordset::IsOpen	Возвращает ненулевое значение, если Open было ранее вызываются.
CRecordset::Move	Располагает набор записей с заданным количеством записей из текущей записи в любом направлении.
CRecordset::MoveFirst	Располагает текущую запись в первую запись в наборе записей. Тест для IsBOF первым.
CRecordset::MoveLast	Располагает текущую запись на последнюю запись или на последний набор строк. Тест для IsEOF первым.
CRecordset::MoveNext	Располагает текущую запись в следующую запись или на следующий набор строк. Тест для IsEOF первым.
CRecordset::MovePrev	Располагает текущую запись на предыдущую запись или на предыдущий набор строк. Тест для IsBOF первым.
CRecordset::OnSetOptions	Вызываемый для задания параметров (используемые в выделенном фрагменте) для определенной выписки ODBC.
CRecordset::OnSetUpdateOptions	Вызываемый для задания параметров, используемых при обновлении () для определенной выписки ODBC.
CRecordset::Open	Открытие набора записей с помощью восстановления таблицы или выполнять запрос, который представляет набор записей.
CRecordset::RefreshRowset	Обновляет данные и состояния, указанных рядков.
CRecordset::Requery	Запускает запрос набора записей, чтобы обновить выбранные записи.
CRecordset::SetAbsolutePosition	Располагает набор записей на запись, соответствующая указанному рекордному число.
CRecordset::SetBookmark	Располагает набор записей на запись, указанную закладкой.
CRecordset::SetFieldDirty	Помечает указанное поле в текущей записи изменен.
CRecordset::SetFieldNull	Задает значение указанного поля в текущей записи к null (не имеющий значение).
CRecordset::SetLockingMode	Устанавливает блокируя режим "оптимистический" блокировать (по умолчанию) или "пессимистический" блокирования. Указывает способ записи блокироватьы for upgrades.
CRecordset::SetParamNull	Устанавливает для указанного параметра значение null (не имеющий значение).
CRecordset::SetRowsetCursorPosition	Располагает курсор на указанную строку в наборе строк.
CRecordset::SetRowsetSize	Указывает количество записей необходимо получить во время выборки.
CRecordset::Update	Выполняет операцию AddNew или Edit путем сохранения новых или отредактированные данных в источнике данных.

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

Имя	Описание
CRecordset::m_hstmt	Содержит дескриптор ODBC для выписки набора записей. Введите HSTMT.
CRecordset::m_nFields	Содержит число элементов данных полей в наборе записей. Введите UINT.
CRecordset::m_nParams	Содержит число элементов данных параметров в наборе записей. Введите UINT.
CRecordset::m_pDatabase	Содержит указатель на объект CDatabase через набор записей для подключения к источнику данных.
CRecordset::m_strFilter	Содержит CString, которое указывает предложение WHERE язык SQL (SQL). Используемый в качестве фильтра, чтобы выбирать только те записи, которые соответствуют определенным критериям.
CRecordset::m_strSort	Содержит CString, которое указывает предложение ORDER BY SQL. Используемый, чтобы контролировать способ записи отсортированы.

Заметки

Наборы записей" как "объекты CRecordset обычно используются в формах: 2 динамические подмножества данных и моментальных снимков. Динамическое подмножество данных остается синхронизированным при обновлении данных, сделанные другими пользователями. Моментальный снимок статическое представление данных. Каждой формой представляет набор записей в момент исправленных набор записей открыт, но при прокрутке к записи в динамическом подмножестве данных, отражает изменения далее, внесенных в записи или другими пользователями или другими наборами записей в приложении.

Примечание

При работе с DAO (DAO) классифицируете, а не классов ODBC (ODBC) использует класс CDaoRecordset.Дополнительные сведения см. в статье Общие сведения: программирование базы данных.

Для работы с любым типом набора записей, как правило наследуется относящийся к приложению класс набора записей из CRecordset. Наборы записей выбирают записи из источника данных, а затем можно:

Прокрутка по записям.
Обновление записи и укажите блокируя режим.
Отфильтровать набор записей, чтобы ограничить записи, оно выберите пункт из доступных в источнике данных.
Сортирует набор записей.
Параметризация набора записей не будет настраивать его выделение со сведениями не известное до времени выполнения.

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

В производном классе CRecordset запись обмен полями записей (RFX) или обмен полями записей (bulk RFX) используются для поддержки чтение и обновление записи полей.

Дополнительные сведения о наборах записей и запись обмене полей см. в разделе Общие сведения: программирование базы данных, статьи набор записей (ODBC), Набор записей. Пакетная выборка строк (ODBC) и Обмен полями записей (RFX). Для фокуса на прослушивание динамических подмножествах данных и моментальных снимках см. статьи динамическое подмножество данных и моментальный снимок.