Proprietà ActiveConnection (ADO)

Articolo
05/30/2023

Indica a quale oggetto Connection appartiene attualmente l'oggetto Command, Recordset o 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 oggetto Variant contenente l'oggetto Connection corrente se la connessione è aperta. Il valore predefinito è un riferimento Null all'oggetto. Vedere la proprietà ConnectionString.

Osservazioni

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

Comando

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

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

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

Nota

Microsoft Visual Basic L'impostazione della proprietà ActiveConnection su Nothing annulla l'associazione dell'oggetto Command dalla Connessione corrente e fa sì che il provider rilasci tutte le risorse associate nell'origine dati. È quindi possibile associare l'oggetto Command allo stesso o a un altro oggetto Connection. Alcuni provider consentono di modificare l'impostazione della proprietà da una Connessione a un'altra senza dover 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 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 consentire l'accesso all'oggetto Connection per informazioni di errore estese o per eseguire altri comandi.

Se si utilizza 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 valida dell'oggetto Command, la proprietà ActiveConnection dell'oggetto Recordset eredita l'impostazione della proprietà ActiveConnection dell'oggetto Command.

Nota

Utilizzo del servizio dati remoto Se usato in un oggetto Recordset lato client, questa proprietà può essere impostata solo su una stringa di connessione oppure, in Microsoft Visual Basic o Visual Basic, Scripting Edition, su Nothing.

Registra

Questa proprietà è di lettura/scrittura quando l'oggetto Record è 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 l'oggetto Record con un oggetto Connection esistente assegnando l'oggetto Connection a questa proprietà oppure usando l'oggetto Connection come parametro nella chiamata al metodo Open. Se l'oggetto Record viene aperto da un oggetto Record o Recordset esistente, viene associato automaticamente all'oggetto Connection dell'oggetto Record o Recordset.