Свойство ConnectionString (ADO)

  • Статья

Указывает сведения, используемые для установления подключения к источнику данных.

Параметры и возвращаемые значения

Задает или возвращает строковое значение.

Комментарии

Свойство ConnectionString используется для указания источника данных путем передачи подробной строки подключения, содержащей ряд операторов argument= value , разделенных точкой с запятой.

ADO поддерживает пять аргументов для свойства ConnectionString ; любые другие аргументы передаются непосредственно поставщику без какой-либо обработки с помощью ADO. Ниже приведены аргументы, поддерживаемые ADO.

Аргумент Описание
Provider= Указывает имя поставщика, используемого для подключения.
Имя файла= Указывает имя файла конкретного поставщика (например, сохраненного объекта источника данных), содержащего предустановленные сведения о подключении.
Удаленный поставщик= Указывает имя поставщика, используемого при открытии клиентского подключения. (Только удаленная служба данных.)
Удаленный сервер= Указывает имя пути сервера, используемого при открытии клиентского подключения. (Только удаленная служба данных.)
URL-адрес= Указывает строку подключения как абсолютный URL-адрес, определяющий ресурс, например файл или каталог.

После установки свойства ConnectionString и открытия объекта Connection поставщик может изменить содержимое свойства, например путем сопоставления имен аргументов, определенных ADO, с их эквивалентами для конкретного поставщика.

Свойство ConnectionString автоматически наследует значение, используемое для аргумента ConnectionString метода Open , поэтому вы можете переопределить текущее свойство ConnectionString во время вызова метода Open .

Так как аргумент Имя файла приводит к загрузке ADO связанного поставщика, невозможно передать оба аргумента поставщик и имя файла .

Свойство ConnectionString доступно для чтения и записи, когда соединение закрыто, и доступно только для чтения, когда оно открыто.

Дубликаты аргумента в свойстве ConnectionString игнорируются. Используется последний экземпляр любого аргумента.

Примечание

Использование службы удаленных данных При использовании в клиентском объекте Connection свойство ConnectionString может включать только параметры Удаленного поставщика и Удаленного сервера .

В следующей таблице перечислены поставщики ADO по умолчанию для каждой операционной системы Windows.

Поставщик ADO по умолчанию Операционная система Windows
MSDASQL

(Чтобы улучшить удобочитаемость исходного кода, явно укажите имя поставщика в строке подключения.)		 Windows 2000 (32-разрядная версия)

Windows XP (32-разрядная версия)

Windows 2003 Server (32-разрядная версия)

Windows Vista (32-разрядная версия)

Windows Vista с пакетом обновления 1 (SP1) или более поздней версии (32-разрядная и 64-разрядная версия)

Версии Windows после Windows Vista (32-разрядная и 64-разрядная версия)
Значение по умолчанию отсутствует.

Если приложение ADO выполняется в следующих операционных системах и не указывает поставщик явным образом, ADO возвращает следующую ошибку: "ADODB. Подключение: поставщик не указан, и поставщик по умолчанию не назначен".		 Windows 2000 (64-разрядная версия)

Windows XP (64-разрядная версия)

Windows 2003 Server (64-разрядная версия)

Windows Vista (64-разрядная версия)

Применение

Объект Connection (ADO)

См. также:

Примеры свойств ConnectionString, ConnectionTimeout и State (VB)
Примеры свойств ConnectionString, ConnectionTimeout и State (VC++)
Приложение А. Поставщики