Метод DBEngine.OpenConnection (DAO)
Область применения: Access 2013, Office 2013
Синтаксис
expression . OpenConnection(Name, Options, ReadOnly, Connect)
expression: переменная, представляющая объект DBEngine.
Параметры
Имя |
Обязательный/необязательный |
Тип данных |
Описание |
|---|---|---|---|
Name |
Обязательный |
String |
Строковое выражение. См. обсуждение в разделе Примечания. |
Options |
Необязательно |
Variant |
задает различные параметры подключения, как указано в разделе Примечания. На основе этого значения диспетчер драйверов ODBC запрашивает у пользователя сведения о подключении, такие как имя источника данных (DSN), имя пользователя и пароль. |
ReadOnly |
Необязательно устанавливать. |
Variant |
Значение true , если подключение должно быть открыто для доступа только для чтения, и false , если подключение должно быть открыто для доступа на чтение и запись (по умолчанию). |
Connect |
Необязательно заполнять. |
Variant |
строка подключения ODBC. Сведения о конкретных элементах и синтаксисе этой строки см. в свойстве Connect . Требуется предварительное значение "ODBC;". |
Возвращаемое значение
Connection
Замечания
Используйте метод OpenConnection , чтобы установить подключение к источнику данных ODBC из рабочей области ODBCDirect. Метод OpenConnection аналогичен, но не эквивалентен OpenDatabase. Отличие main заключается в том, что OpenConnection доступен только в рабочей области ODBCDirect.
Если указать зарегистрированное имя источника данных ODBC (DSN) в аргументе connect, аргумент name может быть любой допустимой строкой, а также предоставить свойство Name для объекта Connection . Если допустимое имя DSN не включено в аргумент connect, имя должно ссылаться на допустимое имя DSN ODBC, которое также будет свойством Name . Если ни имя, ни соединение не содержат допустимого DSN, диспетчер драйверов ODBC можно задать (с помощью аргумента options), чтобы заставить пользователя ввести необходимые сведения о подключении. ИМЯ DSN, предоставленное через запрос, затем предоставляет свойство Name .
Аргумент options определяет, следует ли и когда запрашивать у пользователя установить подключение, а также следует ли открывать подключение асинхронно. Можно использовать одну из следующих констант.
Константа |
Описание |
|---|---|
dbDriverNoPrompt |
Диспетчер драйверов ODBC использует строка подключения, предоставленные в dbname и connect. Если вы не предоставите достаточных сведений, возникает ошибка во время выполнения. |
dbDriverPrompt |
Диспетчер драйверов ODBC отображает диалоговое окно Источники данных ODBC , в котором отображаются все соответствующие сведения, указанные в dbname или connect. Строка подключения состоит из имени DSN, выбранного пользователем в диалоговых окнах, или, если пользователь не указывает dsn, используется имя DSN по умолчанию. |
dbDriverComplete |
Значение, используемое по умолчанию. Если аргумент connect содержит все необходимые сведения для завершения подключения, диспетчер драйверов ODBC использует строку в connect. В противном случае он будет вести себя так же, как при указании dbDriverPrompt. |
dbDriverCompleteRequired |
Этот параметр работает так, как dbDriverComplete , за исключением того, что драйвер ODBC отключает запросы на любые сведения, не необходимые для завершения подключения. |
dbRunAsync |
Выполните метод асинхронно. Эту константу можно использовать с любой из других констант параметров . |
OpenConnection возвращает объект Connection , содержащий сведения о подключении. Объект Connection аналогичен объекту Database . Основное отличие заключается в том, что объект Database обычно представляет базу данных, хотя его можно использовать для представления подключения к источнику данных ODBC из рабочей области Microsoft Access.