Объект Connection (ADO)

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

Замечания

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

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

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

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

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

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

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

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

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

  Примечание.

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

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

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

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

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

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

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

Примечание.

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

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

Чтобы выполнить команду, присвойте команде имя с помощью свойства "Имя объекта команды". Задайте для соединения свойство Active Подключение ion объекта Command. Затем выполните инструкцию, в которой имя команды используется так, как если бы это был метод объекта Подключение ion, а затем любые параметры и объект 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  

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

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

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

Объект Подключение ion является безопасным для сценариев.

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

• свойства, методы и события объекта Подключение ion

См. также

Объект Command (ADO)
Коллекция Errors (ADO)
Коллекция Properties (ADO)
Объект Recordset (ADO)
Приложение А. Поставщики