Шаг 18 - Метод RegisterDatabase

Описание
Заносит сведения о подключении к источнику данных ODBC в реестр Windows. Эти сведения необходимы для драйвера ODBC при открытии источника данных ODBC во время сеанса.

DBEngine.RegisterDatabase имяБД, драйвер, скрытие, атрибуты

Параметры
имяБД
Выражение типа String, содержащее имя, используемое в методе OpenDatabase для ссылки на блок сведений о параметрах источника данных. Например, если источником данных является удаленная база данных ODBC, то данный аргумент задает имя сервера.
драйвер
Выражение типа String, задающее имя драйвера ODBC. Имя драйвера не совпадает с именем файла библиотеки динамической компоновки (DLL) драйвера ODBC. Например, "SQL Server" является именем драйвера, а SQLSRVR.dll является именем файла библиотеки. Программное обеспечение ODBC и соответствующий драйвер должны быть заранее установлены в системе.
скрытие
Выражение типа Boolean, имеющее значение True, если не нужно выводить на экран окна диалога драйвера ODBC, запрашивающие необходимые сведения для драйвера, или значение False при необходимости указать вывод окон диалога драйвера ODBC. Если в аргументе скрытие задано значение True, то аргумент атрибуты должен содержать всю необходимую для конкретного драйвера информацию, иначе окна диалога все равно будут выводиться.
атрибуты
Выражение типа String, содержащее список элементов, которые следует добавить в реестр Windows. Элементы, включаемые в строку атрибутов, разделяются символами возврата каретки.

Замечания
Если база данных уже зарегистрирована, т.е. сведения о подключении уже введены в реестр Windows, то при вызове метода RegisterDatabase сведения о подключении будут обновлены.
Если по какой-либо причине метод RegisterDatabase не может быть выполнен, то изменения в реестр Windows не заносятся и возникает ошибка.
Дополнительные сведения о драйверах ODBC, таких как SQL Server, можно найти в файле справочной системы, поставляемой с конкретным драйвером.
Для добавления новых источников данных или для изменения существующих рекомендуется использовать диалоговое окно ODBC Data Sources в окне настройка Windows. Если, однако, по каким то причинам предпочтительнее использовать метод RegisterDatabase, рекомендуется задавать для аргумента скрытие значение True.

Пример
Следующая программа использует метод RegisterDatabase для регистрации источника данных Microsoft SQL Server "Publishers" в реестре Windows.
Лучшим способом создания, изменения или удаления имен источников данных является использование значка "ODBC" панели управления Windows.

Sub RegisterDatabaseX()

	Dim dbsRegister As Database
	Dim strDescription As String
	Dim strAttributes As String
	Dim errLoop As Error

	' Создает строку ключевых слов.
	strDescription = InputBox( "Введите описание " & "регистрируемой базы данных.")
	strAttributes = "Database=pubs" & _
		vbCr & "Description=" & strDescription & vbCr & "OemToAnsi=No" & vbCr & "Server=Server1"
	' Обновляет реестр Windows.
	On Error GoTo Err_Register

	DBEngine.RegisterDatabase "Publishers", "SQL Server", True, strAttributes
	On Error GoTo 0
	MsgBox "Для просмотра изменений вызовите " & "regedit.exe: " & "HKEY_CURRENT_USER\" & 	"Software\ODBC\ODBC.INI"
	Exit Sub
Err_Register:
	' Уведомляет пользователя о любых ошибках, 
	' являющихся  следствием недопустимых данных.
	If DBEngine.Errors.Count > 0 Then
		For Each errLoop In DBEngine.Errors
			MsgBox "Код ошибки: " & errLoop.Number & vbCr & errLoop.Description
		Next errLoop
	End If
	Resume Next
End Sub

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем.