Proprietà ActiveConnection (ADO)

Indica a quale oggetto Connection appartiene attualmente l'oggetto Command, Recordseto Record specificato.

Impostazioni e valori restituiti

Imposta o restituisce un valore String che contiene una definizione per una connessione se la connessione è chiusa o un elemento Variant contenente l'oggetto Connection corrente se la connessione è aperta. Il valore predefinito è un riferimento a un oggetto Null. Vedere la proprietà ConnectionString.

Commenti

Usare la proprietà ActiveConnection per determinare l'oggetto Connection su cui verrà eseguito l'oggetto Command specificato o verrà aperto il recordset specificato.

Comando

Per gli oggetti Command, la proprietà ActiveConnection è di lettura/scrittura.

Se si tenta di chiamare il metodo Execute su un oggetto Command prima di impostare questa proprietà su un oggetto Connection aperto o su una stringa di connessione valida, si verifica un errore.

Se alla proprietà ActiveConnection viene assegnato un oggetto Connection, l'oggetto deve essere aperto. L'assegnazione di un oggetto Connection chiuso causa un errore.

Nota

Microsoft Visual Basic Se si imposta la proprietà ActiveConnection su Nothing, l'oggetto Command viene dissociato dall'oggetto Connection corrente e il provider rilascia tutte le risorse associate nell'origine dati. È quindi possibile associare l'oggetto Command allo stesso oggetto Connection o a un altro oggetto . Alcuni provider consentono di modificare l'impostazione della proprietà da una connessione a un'altra, senza prima impostare la proprietà su Nothing.

Se la raccolta Parameters dell'oggetto Command contiene parametri forniti dal provider, la raccolta viene cancellata se si imposta la proprietà ActiveConnection su Nothing o su un altro oggetto Connection. Se si creano manualmente oggetti Parameter e li si usano per riempire la raccolta Parameters dell'oggetto Command, l'impostazione della proprietà ActiveConnection su Nothing o su un altro oggetto Connection lascia intatta la raccolta Parameters.

La chiusura dell'oggetto Connection a cui è associato un oggetto Command imposta la proprietà ActiveConnection su Nothing. L'impostazione di questa proprietà su un oggetto Connection chiuso genera un errore.

recordset

Per gli oggetti Recordset aperti o per gli oggetti Recordset la cui proprietà Source è impostata su un oggetto Command valido, la proprietà ActiveConnection è di sola lettura. In caso contrario, è di lettura/scrittura.

È possibile impostare questa proprietà su un oggetto Connection valido o su una stringa di connessione valida. In questo caso, il provider crea un nuovo oggetto Connection usando questa definizione e apre la connessione. Inoltre, il provider può impostare questa proprietà sul nuovo oggetto Connection per fornire un modo per accedere all'oggetto Connection per informazioni estese sugli errori o per eseguire altri comandi.

Se si usa l'argomento ActiveConnection del metodo Open per aprire un oggetto Recordset, la proprietà ActiveConnection erediterà il valore dell'argomento.

Se si imposta la proprietà Source dell'oggetto Recordset su una variabile oggetto Command valida, la proprietà ActiveConnection del recordset eredita l'impostazione della proprietà ActiveConnection dell'oggetto Command.

Nota

Utilizzo di Remote Data Service Se utilizzata in un oggetto Recordset lato client, questa proprietà può essere impostata solo su una stringa di connessione o (in Microsoft Visual Basic o Visual Basic, Scripting Edition) su Nothing.

Registra

Questa proprietà è di lettura/scrittura quando l'oggetto Record viene chiuso e può contenere una stringa di connessione o un riferimento a un oggetto Connection aperto. Questa proprietà è di sola lettura quando l'oggetto Record è aperto e contiene un riferimento a un oggetto Connection aperto.

Un oggetto Connection viene creato in modo implicito quando l'oggetto Record viene aperto da un URL. Aprire il record con un oggetto Connection esistente assegnando l'oggetto Connection a questa proprietà o usando l'oggetto Connection come parametro nella chiamata al metodo Open. Se il record viene aperto da un record o un recordsetesistente, viene associato automaticamente all'oggetto Connection di tale oggetto Record o Recordset.

Nota

Gli URL che usano lo schema HTTP richiamano automaticamente microsoft OLE DB Provider per Internet Publishing. Per altre informazioni, vedere URL assoluti e relativi.

Si applica a

Vedere anche

Esempio delle proprietà ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (VB)
Esempio delle proprietà ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (VC++)
Esempio delle proprietà ActiveConnection, CommandText, CommandTimeout, CommandType, Size e Direction (JScript)
Oggetto Connection (ADO)
Proprietà ConnectionString (ADO)