Объект соединения (ADO)

Представляет открытое подключение к источнику данных.

Замечания

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

С помощью коллекций, методов и свойств объекта Connection можно выполнить следующее:

  • Настройте подключение перед открытием с помощью свойств ConnectionString, ConnectionTimeout и Mode . ConnectionString — это свойство по умолчанию объекта Connection .

  • Задайте свойству CursorLocation значение клиента, чтобы вызвать службу курсоров Майкрософт для OLE DB, которая поддерживает пакетные обновления.

  • Задайте базу данных по умолчанию для подключения к свойству DefaultDatabase .

  • Задайте уровень изоляции для транзакций, открытых в соединении со свойством IsolationLevel .

  • Укажите поставщика OLE DB со свойством Provider .

  • Установите и более поздний разрыв физического подключения к источнику данных с помощью методов Open и Close .

  • Выполните команду в соединении с методом Execute и настройте выполнение с помощью свойства CommandTimeout .

    Замечание

    Чтобы выполнить запрос без использования объекта Command, передайте строку запроса методу Execute объекта Connection . Однако объект Command требуется, если требуется сохранить текст команды и повторно выполнить его или использовать параметры запроса.

  • Управление транзакциями в открытом подключении, включая вложенные транзакции, если поставщик их поддерживает, с помощью методов BeginTrans, CommitTrans и RollbackTrans и свойства Attributes .

  • Проверьте ошибки, возвращаемые из источника данных, с помощью коллекции ошибок .

  • Чтение версии из реализации ADO, используемой с свойством Version .

  • Получите сведения о схеме базы данных с помощью метода OpenSchema .

Объекты Connection можно создавать независимо от любого другого ранее определенного объекта.

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

Замечание

Не используйте эту функцию (вызывая именованную команду или хранимую процедуру, как если бы это был собственный метод для объекта Connection ) в приложении Microsoft .NET Framework, так как базовая реализация функции конфликтует с тем, как платформа .NET Framework взаимодействует с COM.

Выполнение команды в качестве собственного метода объекта Connection

Чтобы выполнить команду, присвойте команде имя с помощью свойства "Имя объекта команды". Задайте свойству ActiveConnection объекта Command значение подключения. Затем выполните инструкцию, в которой имя команды используется так, как если бы это был метод объекта Connection , за которым следуют все параметры, а также объект Recordset , если возвращаются строки. Задайте свойства набора записей для настройки результирующего набора записей. Рассмотрим пример.

Dim cnn As New ADODB.Connection  
Dim cmd As New ADODB.Command  
Dim rst As New ADODB.Recordset  
...  
cnn.Open "..."  
cmd.Name = "yourCommandName"  
cmd.ActiveConnection = cnn  
...  
'Your command name, any parameters, and an optional Recordset.  
cnn. "parameter", rst

Выполнение хранимой процедуры в качестве собственного метода объекта Connection

Чтобы выполнить хранимую процедуру, выполните инструкцию, в которой имя хранимой процедуры используется, как если бы он был методом объекта Connection , за которым следует все параметры. ADO сделает "лучшее угадывание" типов параметров. Рассмотрим пример.

Dim cnn As New ADODB.Connection  
...  
'Your stored procedure name and any parameters.  
cnn. "parameter"

Объект Connection безопасно для сценариев.

Этот раздел содержит следующую тему.

См. также

объекта команд (ADO)
коллекции ошибок (ADO)
Коллекция свойств (ADO)
объекта набора записей
Приложение A: Поставщики

  • Last updated on