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

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

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

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

Remarks

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

Команда

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

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

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

Примечание

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

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

Закрытие объекта 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.

Примечание

URL-адреса, использующие схему HTTP, автоматически вызывают поставщик Microsoft OLE DB для публикации в Интернете. Дополнительные сведения см. в разделе Абсолютные и относительные URL-адреса.

Применение

См. также:

ActiveConnection, CommandText, CommandTimeout, CommandType, Size и Direction Properties Example (VB)
Пример свойств ActiveConnection, CommandText, CommandTimeout, CommandType, Size и Direction (VC++)
ActiveConnection, CommandText, CommandTimeout, CommandType, Size и Direction Properties Example (JScript)
Объект Connection (ADO)
Свойство ConnectionString (ADO)