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

Указывает, к какой объекту Connection принадлежит указанный объект Command, Recordset или Record .

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

Задает или возвращает строковое значение, содержащее определение подключения, если соединение закрыто, или вариант , содержащий текущий объект Connection , если соединение открыто. По умолчанию используется ссылка на объект NULL. См. свойство ConnectionString .

Замечания

Используйте свойство ActiveConnection , чтобы определить объект Connection , над которым будет выполняться указанный объект Command , или откроется указанный набор записей .

командование

Для объектов Command свойство ActiveConnection является чтением и записью.

Если вы пытаетесь вызвать метод Execute в объекте Command перед установкой этого свойства на открытый объект connection или допустимую строку подключения , возникает ошибка.

Если объект Connection назначен свойству ActiveConnection , объект должен быть открыт. Назначение закрытого объекта подключения приводит к ошибке.

Замечание

Microsoft Visual Basic При задании свойства ActiveConnection значение Nothing отсоединяет объект Command от текущего подключения и поставщик освобождает все связанные ресурсы в источнике данных. Затем можно связать объект Command с тем же или другим объектом Connection . Некоторые поставщики позволяют изменять параметр свойства с одного подключения к другому, не устанавливая свойство в значение Nothing.

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

Закрытие объекта Connection , с которым связан объект Command , задает свойству ActiveConnection значение Nothing. Если задать это свойство для закрытого объекта Connection , возникает ошибка.

Набор записей

Для открытых объектов Recordset или для объектов Recordset, свойство Source которого имеет допустимое значение Command, свойство ActiveConnection доступно только для чтения. В противном случае оно считывается и записывается.

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

Если для открытия объекта Recordset используется аргумент ActiveConnection метода Open, свойство ActiveConnection наследует значение аргумента.

Если для свойства Source объекта Recordset задана допустимая переменная объекта Command, свойство ActiveConnection набора Recordset наследует параметр свойства ActiveConnection объекта Command.

Замечание

Использование службы удаленных данных При использовании в объекте набора записей на стороне клиента это свойство можно задать только для строки подключения или (в Microsoft Visual Basic или Visual Basic, Scripting Edition) значение Nothing.

Запись

Это свойство считывается и записывается при закрытии объекта Record и может содержать строку подключения или ссылку на открытый объект Connection . Это свойство доступно только для чтения, если объект Record открыт и содержит ссылку на открытый объект Connection .

Объект Connection создается неявно при открытии объекта Record из URL-адреса. Откройте запись с существующим, откройте объект Connection , назначив объект Connection этому свойству или используя объект Connection в качестве параметра в вызове метода Open . Если запись открыта из существующего набора записей или набора записей, он автоматически связывается с объектом Connection объекта Record или Recordset.