CRecordset::Open

віртуальнийBOOLOpen (UINTnOpenType=AFX_DB_USE_DEFAULT_TYPE,LPCTSTR,lpszSQL=,NULL,DWORDdwOptions=жодна);
кинути ( CDBException, CMemoryException );

Значення, яке повертається

Ненульовий, якщо об'єкт CRecordset успішно відкрито; в іншому випадку 0, якщо CDatabase::Open (якщо назвати) повертає 0.

Параметри

nOpenType

Приймати значення за замовчуванням, AFX_DB_USE_DEFAULT_TYPE, або використовувати одне з таких значень від enum OpenType:

lpszSQL

Рядковий вказівник, що містить одну з нижченаведених дій:

dwOptions

Бітова маска, який можна вказати комбінації значень, наведених нижче. Деякі з них є взаємовиключними. Значення за промовчанням — Ні.

Зауваження

Ви повинні зателефонувати цієї функції-члена запустити запит, визначений набір записів. Перед викликом, відкриті, ви повинні побудувати набору записів об'єкта.

Цей набір записів підключення до джерела даних залежить від того, як побудовано набір записів перед викликом відкритим. Якщо ви передаєте CDatabase об'єкт в конструктор набір записів, які не підключено до джерела даних, цей член функція використовує GetDefaultConnect для відкриття об'єкта бази даних. Якщо ви передаєте NULL в recordset Конструктор, конструктор конструкції CDatabase об'єкт для вас, і відкриті намагається підключитися до об'єкта бази даних. Докладну інформацію про закриття записів та підключення до цих різних обставин побачити Закрити.

Примітка   Доступ до джерела даних через CRecordset об'єкт завжди Загальні. На відміну від CDaoRecordset клас CRecordset об'єкт не можна використовувати для відкриття джерела даних для монопольного доступу.

Коли ви називаєте відкрито, на, зазвичай заяви SQL Виберіть , добору записів на основі критеріїв, показано в нижченаведеній таблиці.

Значення параметра lpszSQL Записи вибрано визначається Приклад
NULL Рядок, повернутих GetDefaultSQL.
Ім'я таблиці SQL Усі стовпці таблиці списку в DoFieldExchange або DoBulkFieldExchange. 
 "Клієнт"
Ім'я попередньо визначений запит (збережених процедур) Стовпці, які визначено запит для повернення. 
"{виклик OverDueAccts}"
Виберіть стовпець списку від Таблиця список Указаний стовпці з указаного одну або декілька таблиць. 
"Виберіть CustId, CustName від клієнта"

! Попередження   Будьте обережні, не вставляти прогалин у ваш SQL рядок. Наприклад, якщо вставити пробіли між фігурна дужка і ЗАТЕЛЕФОНУВАТИ ключове слово MFC буде інтерпретувати як ім'я таблиці, рядок SQL і включити його в Виберіть заяву, яка призведе до виключення бути кинуті. Аналогічним чином, якщо попередньо визначений запит використовує виводу-параметр, не вставляти пробіл між фігурна дужка і що '?' символ. Нарешті, ви повинні не вставити пробіли перед фігурна дужка в заяві, ЗАТЕЛЕФОНУЙТЕ або перед Виберіть ключове слово в Виберіть заявою.

Звичайна процедура є передати NULL відкритим; При цьому, Відкрити дзвінки GetDefaultSQL. Якщо ви використовуєте похідного класу CRecordset , GetDefualtSQL дає ім'я таблиці, вказаний в ClassWizard. Замість цього можна вказати іншу інформацію в параметрі lpszSQL.

Все, що ви проходите, відкриті конструкції останній рядок SQL для запиту (рядок може мати SQL де і ORDER BY положення, що додається до рядка lpszSQL , який ви пройшли) і потім виконує запит. Ви можете вивчити побудовані рядок за номером GetSQL після виклик Open. За додаткові відомості про те, як набір записів конструкції інструкцію SQL і відбору записів, перегляньте статтю набір записів: як набори записів виберіть записи (ODBC) в Visual C++ програміста керівництво.

Поле даних члени ваш клас набору записів пов'язані стовпців даних, який вибрано. Якщо будь-які записи повертаються, перший запис стає поточний запис.

Якщо потрібно настроїти параметри набору записів, наприклад, фільтрування або сортування, вкажіть ці після того, як ви побудувати набору записів об'єкта, але перш ніж ви називаєте відкриті. Якщо ви хочете оновити записи у наборі записів, після того, як набір записів уже відкрито, зателефонуйте Повторний запит.

Для отримання додаткової інформації, у тому числі додаткові приклади, перегляньте статті Набір записів (ODBC), набір записів: як набори записів виберіть записи (ODBC), і набір записів: створення та закриття набори записів (ODBC) в Visual C++ програміста керівництво.

Приклад

У наведених нижче прикладах показати різні форми відкритий виклик.

/ / rs є на CRecordset або
/ / CRecordset, отриманих об'єкта

/ / Відкриті rs, використовуючи стандартний SQL-оператор,
/ / реалізувати закладки та вимкнення
/ / Перевірка брудні полів
RS.Відкрити (CRecordset::snapshot, &NULL,
 nbsp;       CRecordset::useBookmarks |
         CRecordset::noDirtyFieldCheck);

/ / Пройти повне Оператор SELECT
/ / і відкритим як в динамічних бібліотек
RS.Відкрийте (CRecordset::dynaset,
         _T ("виберіть L_Name від клієнта"));

/ / Прийняти всі настройки за замовчуванням
RS.(Відкриті)

Огляд CRecordset |  Члени класу | Ієрархічна діаграма

Дивіться також CRecordset::CRecordset, CRecordset::Close, CRecordset::GetDefaultSQL, CRecordset::GetSQL, CRecordset::m_strFilter, CRecordset::m_strSort, CRecordset::Requery

Index