Поделиться через

Объект connection (ADO)

  • Статья

Область применения: Access 2013, Office 2013

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

Замечания

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

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

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

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

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

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

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

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

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

    Примечание.

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

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

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

  • Считывает версию из реализации ADO, используемой со свойством Version .

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

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

Команды или хранимые процедуры можно выполнять так, как если бы они были собственными методами для объекта Connection , как показано ниже.

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

Чтобы выполнить команду, присвойте команде имя с помощью свойства Command object Name . Задайте для свойства ActiveConnection объекта Command значение соединения. Затем выполните инструкцию, в которой имя команды используется так, как если бы это был метод для объекта Connection , за которым следуют любые параметры, а затем объект Recordset , если возвращаются какие-либо строки. Задайте свойства 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.yourCommandName "parameter", rst

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

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

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