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

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

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

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

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

Замечания

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

Command

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

При попытке вызвать метод Execute для объекта Command перед заданием для этого свойства открытого объекта 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 или объектов Recordset , для которых свойству Source присвоен допустимый объект Command , свойство ActiveConnection доступно только для чтения. В противном случае выполняется чтение и запись.

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

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

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

Удаленное использование службы данных. При использовании в клиентском объекте Recordset для этого свойства можно задать только строка подключения или (в 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-адреса.