Condividi tramite

Oggetto Connection (ADO)

Rappresenta una connessione aperta a un'origine dati.

Osservazioni:

Un oggetto Connection rappresenta una sessione univoca con un'origine dati. In un sistema di database client/server può essere equivalente a una connessione di rete effettiva al server. A seconda delle funzionalità supportate dal provider, alcuni insiemi, metodi o proprietà di un oggetto Connection potrebbero non essere disponibili.

Con le raccolte, i metodi e le proprietà di un oggetto Connection , è possibile eseguire le operazioni seguenti:

  • Configurare la connessione prima di aprirla con le proprietà ConnectionString, ConnectionTimeout e Mode . ConnectionString è la proprietà predefinita dell'oggetto Connection .

  • Impostare la proprietà CursorLocation sul client per richiamare il servizio cursore Microsoft per OLE DB, che supporta gli aggiornamenti batch.

  • Impostare il database predefinito per la connessione con la proprietà DefaultDatabase .

  • Impostare il livello di isolamento per le transazioni aperte nella connessione con la proprietà IsolationLevel .

  • Specificare un provider OLE DB con la proprietà Provider .

  • Stabilire e in seguito interrompere la connessione fisica all'origine dati con i metodi Open e Close .

  • Eseguire un comando sulla connessione con il metodo Execute e configurare l'esecuzione con la proprietà CommandTimeout .

    Annotazioni

    Per eseguire una query senza utilizzare un oggetto Command, passare una stringa di query al metodo Execute di un oggetto Connection . Tuttavia, è necessario un oggetto Command quando si desidera rendere persistente il testo del comando e eseguirlo di nuovo oppure usare i parametri di query.

  • Gestire le transazioni nella connessione aperta, incluse le transazioni annidate se il provider le supporta, con i metodi BeginTrans, CommitTrans e RollbackTrans e la proprietà Attributes .

  • Esaminare gli errori restituiti dall'origine dati con la raccolta Errors .

  • Leggere la versione dall'implementazione di ADO usata con la proprietà Version .

  • Ottenere informazioni sullo schema sul database con il metodo OpenSchema .

È possibile creare oggetti Connection indipendentemente da qualsiasi altro oggetto definito in precedenza.

È possibile eseguire comandi denominati o stored procedure come se fossero metodi nativi in un oggetto Connection , come illustrato nella sezione successiva. Quando un comando denominato ha lo stesso nome di una stored procedure, richiamare la "chiamata al metodo nativo" in un oggetto Connection eseguire sempre il comando denominato anziché la stored procedure.

Annotazioni

Non usare questa funzionalità (chiamata di un comando denominato o stored procedure come se fosse un metodo nativo nell'oggetto Connection ) in un'applicazione Microsoft .NET Framework, perché l'implementazione sottostante della funzionalità è in conflitto con il modo in cui .NET Framework interagisce con COM.

Eseguire un comando come metodo nativo di un oggetto Connection

Per eseguire un comando, assegnare un nome al comando usando la proprietà Nome oggetto Command. Impostare la proprietà ActiveConnection dell'oggetto Command sulla connessione. Eseguire quindi un'istruzione in cui il nome del comando viene usato come se fosse un metodo nell'oggetto Connection , seguito da qualsiasi parametro e da un oggetto Recordset se vengono restituite righe. Impostare le proprietà Recordset per personalizzare l'oggetto Recordset risultante. Per esempio:

Dim cnn As New ADODB.Connection  
Dim cmd As New ADODB.Command  
Dim rst As New ADODB.Recordset  
...  
cnn.Open "..."  
cmd.Name = "yourCommandName"  
cmd.ActiveConnection = cnn  
...  
'Your command name, any parameters, and an optional Recordset.  
cnn. "parameter", rst

Eseguire una stored procedure come metodo nativo di un oggetto Connection

Per eseguire una stored procedure, eseguire un'istruzione in cui viene utilizzato il nome della stored procedure come se fosse un metodo nell'oggetto Connection , seguito da qualsiasi parametro. ADO creerà una "ipotesi migliore" dei tipi di parametri. Per esempio:

Dim cnn As New ADODB.Connection  
...  
'Your stored procedure name and any parameters.  
cnn. "parameter"

L'oggetto Connection è sicuro per lo scripting.

Questa sezione contiene l'argomento seguente.

Vedere anche

dell'oggetto Command (ADO)
Insieme Errors (ADO)
Collezione Properties (ADO)
oggetto Recordset (ADO)
Appendice A: Fornitori

  • Last updated on