Oggetto Connection (ADO)

  • Articolo

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 un'effettiva connessione di rete al server. A seconda della funzionalità supportata dal provider, alcune raccolte, 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 Microsoft Cursor Service 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 interrompere in seguito 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.

    Nota

    Per eseguire una query senza usare un oggetto Command, passare una stringa di query al metodo Execute di un oggetto Connection. Tuttavia, è necessario un oggetto Command quando si vuole salvare in modo permanente il testo del comando ed eseguirlo nuovamente oppure usare i parametri di query.

  • Gestire le transazioni sulla connessione aperta, incluse le transazioni annidate se supportate dal provider, 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 relative al 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 e si richiama la "chiamata al metodo nativo" su un oggetto Connection, viene sempre eseguito il comando denominato anziché la stored procedure.

Nota

Non usare questa funzionalità (chiamata di un comando denominato o stored procedure come se fosse un metodo nativo nell'oggetto Connessione ion) 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à Name dell'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 sull'oggetto Connection, seguito da qualsiasi parametro, e un oggetto Recordset se vengono restituite righe. Impostare le proprietà Recordset per personalizzare l'oggetto Recordset risultante. Ad 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 il nome della stored procedure viene usato come se fosse un metodo sull'oggetto Connection, seguito da qualsiasi parametro. ADO proverà a ipotizzare i tipi di parametri. Ad esempio:

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

L'oggetto Connection è sicuro per lo scripting.

In questa sezione viene trattato l'argomento seguente.

Vedi anche

Oggetto Command (ADO)
Raccolta di errori (ADO)
Raccolta delle proprietà (ADO)
Oggetto Recordset (ADO)
Appendice A: Provider