Свойство 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-разрядная версия) |
Применение
См. также:
Примеры свойств ConnectionString, ConnectionTimeout и State (VB)
Примеры свойств ConnectionString, ConnectionTimeout и State (VC++)
Приложение А. Поставщики
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по