CDatabase::Open

ВиртуальныйBOOLОткрытые (LPCTSTRlpszDSN,BOOLbExclusive = FALSE,BOOLbReadOnly = FALSE,LPCTSTRlpszConnect ==правда "ODBC;",BOOLbUseCursorLib);
бросить ( CDBException, CMemoryException );

Возвращаемое значение

Ненулевое значение, если подключение выполнено успешно; в противном случае 0, если пользователь решит отменить, когда диалоговое окно запрашивает дополнительные сведения о соединении. Во всех остальных случаях платформа создает исключения.

Параметры

lpszDSN

Указывает имя источника данных — имя зарегистрирован с ODBC через программу Администратор ODBC. Если указано значение DSN в lpszConnect (в виде "DSN = lt; источник данных >"), она должна не быть определены снова в lpszDSN. В этом случае lpszDSN должен иметь значение NULL. В противном случае вы можете передать значение NULL , если вы хотите предоставить пользователю диалоговое окно Источник данных, в котором можно выбрать источник данных. Для получения дополнительной информации см. примечания.

bExclusive

Не поддерживаются в этой версии библиотеки классов. В настоящее время утверждение не выполняется, если этот параметр имеет значение TRUE. Источник данных всегда открыты общие (не эксклюзивный).

bReadOnly

Значение TRUE, если требуется подключение к быть доступным только для чтения и запретить обновления в источнике данных. Все зависимые наборы записей наследуют этот атрибут. Значение по умолчанию — FALSE.

lpszConnect

Задает строку подключения. Строки соединения объединяет информацию, возможно, включая имя источника данных, Идентификатора пользователя действительный на источнике данных, строка аутентификации пользователя (пароль, если источник данных требует один) и другой информации. Вся строка подключения должен стоять в строке «ODBC;» (верхний или нижний регистр). «ODBC;» строка используется для указания того, что подключение к источнику данных ODBC; Это для вертикальной совместимости, когда будущие версии библиотеки классов могут поддерживать источники данных-ODBC.

bUseCursorLib

Значение TRUE , если вы хотите, чтобы DLL библиотеки курсоров ODBC для загрузки. Библиотека курсоров скрывает некоторые функциональные возможности базового драйвера ODBC, фактически исключает использование подмножества (если драйвер поддерживает их). Статические снимки и однонаправленные курсоры только курсоры поддерживают если библиотека курсоров загружается. Значение по умолчанию — TRUE. Если вы планируете создать объект recordset непосредственно от CRecordset не вытекающие из него, вам не следует загрузить библиотеку курсоров.

Примечания

Этот член функция вызывается для инициализации недавно построенного объекта CDatabase . Ваш объект базы данных должны быть инициализированы перед использованием его для построения объекта набора записей.

Примечание   Вызов функции-члена OpenEx является предпочтительным способом для подключения к источнику данных и инициализировать объект базы данных.

Если параметры в открытый вызов не содержит достаточно сведений для подключения, драйвер ODBC открывает диалоговое окно для получения необходимой информации от пользователя. При вызове открытым, connect, lpszConnect, хранится конфиденциально в объект CDatabase и доступен путем вызова функции-члена GetConnect.

Если вы желаете, можно открыть собственное диалоговое, прежде чем вы вызвать Открыть для получения информации от пользователя, такие как пароль, затем добавить эту информацию в строку соединения, передаваемых для открытия. Или вы можете сохранить строку подключения вам пройти так можно повторно использовать это приложение вызывает открытыми на объект CDatabase следующий раз.

Можно также использовать строки подключения для нескольких уровней авторизации логин (каждый на другой объект CDatabase ) или для передачи другой информации конкретного источника данных. Для получения дополнительных сведений о строк подключения, см. главу 5 в Справочник программиста ODBC SDK.

Это возможно для попытке подключения времени ожидания, если, например, СУБД хост недоступен. Если попытка соединения не удается, открытый создает CDBException.

Пример

/ / Внедрить объект CDatabase
/ / в вашем классе документа
CDatabase m_dbCust;

/ / Подключить объект
/ / данных источника (без пароля)
/ / диалогового окна подключение ODBC
/ / всегда будет оставаться скрытым
m_dbCust.Open (_T ("MYDATASOURCE"), ложь,
 nbsp;             ЗНАЧЕНИЕ FALSE, _T ("ODBC;UID = JOES "),

// ...Или запрос пользователя для всех
/ / сведения о подключении
m_dbCust.Open (&NULL)

Обзор CDatabaseЧлены класса | Иерархическая схема

См. также CDatabase::OpenEx, CDatabase::CDatabase, CDatabase::Close, CDBException, CRecordset::Open

Index