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

Указывает, к какому объекту соединения в данный момент принадлежит указанная команда, набор записейили объект записи .Indicates to which Connection object the specified Command, Recordset, or Record object currently belongs.

Параметры и возвращаемые значенияSettings and Return Values

Задает или возвращает строковое значение, содержащее определение соединения, если соединение закрыто, или вариант , содержащий текущий объект соединения , если соединение открыто.Sets or returns a String value that contains a definition for a connection if the connection is closed, or a Variant containing the current Connection object if the connection is open. По умолчанию используется пустая ссылка на объект.Default is a null object reference. См. свойство ConnectionString .See the ConnectionString property.

RemarksRemarks

Используйте свойство ActiveConnection , чтобы определить объект соединения , для которого будет выполняться указанный объект команды , или будет открыт указанный набор записей .Use the ActiveConnection property to determine the Connection object over which the specified Command object will execute or the specified Recordset will be opened.

КомандаCommand

Для объектов Command свойство ActiveConnection доступно для чтения и записи.For Command objects, the ActiveConnection property is read/write.

При попытке вызвать метод EXECUTE для объекта Command перед установкой этого свойства в открытый объект соединения или допустимую строку подключения возникнет ошибка.If you attempt to call the Execute method on a Command object before setting this property to an open Connection object or valid connection string, an error occurs.

Если объект соединения назначен свойству ActiveConnection , то объект должен быть открыт.If a Connection object is assigned to the ActiveConnection property, the object must be opened. При назначении закрытого объекта соединения возникает ошибка.Assigning a closed Connection object causes an error.

Примечание.Note

Microsoft Visual Basic Если задать для свойства ActiveConnection значение Nothing, объект команды не будет связан с текущим соединением и будет вызван тем, что поставщик выпустит все связанные ресурсы в источнике данных.Microsoft Visual Basic Setting the ActiveConnection property to Nothing disassociates the Command object from the current Connection and causes the provider to release any associated resources on the data source. Затем можно связать объект команды с тем же или с другим объектом Connection .You can then associate the Command object with the same or another Connection object. Некоторые поставщики позволяют изменить значение свойства с одного соединения на другое без необходимости присвоить свойству значение Nothing.Some providers allow you to change the property setting from one Connection to another, without having to first set the property to Nothing.

Если коллекция Parameters объекта Command содержит параметры, предоставленные поставщиком, коллекция удаляется, если для свойства ActiveConnection задано значение Nothing или другой объект соединения .If the Parameters collection of the Command object contains parameters supplied by the provider, the collection is cleared if you set the ActiveConnection property to Nothing or to another Connection object. Если вы вручную создаете объекты параметров и используете их для заполнения коллекции Parameters объекта Command , установка свойства ActiveConnection в значение Nothing или на другой объект соединения оставляет коллекцию параметров неизменной.If you manually create Parameter objects and use them to fill the Parameters collection of the Command object, setting the ActiveConnection property to Nothing or to another Connection object leaves the Parameters collection intact.

При закрытии объекта соединения , с которым связан объект команды , свойству ActiveConnection присваивается значение Nothing.Closing the Connection object with which a Command object is associated sets the ActiveConnection property to Nothing. При присвоении этому свойству закрытого объекта соединения выдается ошибка.Setting this property to a closed Connection object generates an error.

набор записейRecordset

Для открытых объектов Recordset или для объектов набора записей , свойству Source которых задан допустимый объект Command , свойство ActiveConnection доступно только для чтения.For open Recordset objects or for Recordset objects whose Source property is set to a valid Command object, the ActiveConnection property is read-only. В противном случае он доступен для чтения и записи.Otherwise, it is read/write.

Этому свойству можно присвоить допустимый объект соединения или допустимую строку подключения.You can set this property to a valid Connection object or to a valid connection string. В этом случае поставщик создает новый объект соединения с помощью этого определения и открывает соединение.In this case, the provider creates a new Connection object using this definition and opens the connection. Кроме того, поставщик может задать этому свойству новый объект соединения , чтобы предоставить возможность доступа к объекту соединения для получения расширенных сведений об ошибках или выполнения других команд.Additionally, the provider may set this property to the new Connection object to give you a way to access the Connection object for extended error information or to execute other commands.

При использовании аргумента ActiveConnection метода Open для открытия объекта Recordset свойство ActiveConnection будет наследовать значение аргумента.If you use the ActiveConnection argument of the Open method to open a Recordset object, the ActiveConnection property will inherit the value of the argument.

Если свойству Source объекта Recordset присвоено значение допустимой переменной объекта Command , свойство ActiveConnection набора записей наследует значение свойства ActiveConnection объекта Command .If you set the Source property of the Recordset object to a valid Command object variable, the ActiveConnection property of the Recordset inherits the setting of the Command object's ActiveConnection property.

Примечание

Использование удаленной службы данных При использовании объекта набора записей на стороне клиента это свойство может быть установлено только в строку подключения или (в Microsoft Visual Basic или Visual Basic, Scripting Edition) в значение Nothing.Remote Data Service Usage When used on a client-side Recordset object, this property can be set only to a connection string or (in Microsoft Visual Basic or Visual Basic, Scripting Edition) to Nothing.

ЗаписейRecord

Это свойство доступно для чтения и записи при закрытии объекта Record и может содержать строку соединения или ссылку на открытый объект соединения .This property is read/write when the Record object is closed, and may contain a connection string or reference to an open Connection object. Это свойство доступно только для чтения, если объект Record открыт, и содержит ссылку на открытый объект соединения .This property is read-only when the Record object is open, and contains a reference to an open Connection object.

Объект соединения создается неявно при открытии объекта Record из URL-адреса.A Connection object is created implicitly when the Record object is opened from a URL. Откройте запись с существующим открытым объектом соединения , назначив этому свойству объект соединения или используя объект соединения в качестве параметра в вызове метода Open .Open the Record with an existing, open Connection object by assigning the Connection object to this property, or using the Connection object as a parameter in the Open method call. Если запись была открыта из существующей записи или набора записей, то она автоматически связывается с объектом соединения записи или объекта набора записей .If the Record is opened from an existing Record or Recordset, then it is automatically associated with that Record or Recordset object's Connection object.

Примечание

URL-адреса, использующие схему HTTP, автоматически вызывают поставщик OLE DB Майкрософт для публикации в Интернете.URLs using the http scheme will automatically invoke the Microsoft OLE DB Provider for Internet Publishing. Дополнительные сведения см. в разделе абсолютные и относительные URL-адреса.For more information, see Absolute and Relative URLs.

ПрименениеApplies To

См. такжеSee Also

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