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

Статья
06/02/2023

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

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

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

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

Get-Help

Для объектов 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.

Примечание

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

Record

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

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