ADO Connection Object
Connection Object
The ADO Connection object is used to create an open connection to a data source. Through this connection, you can access and manipulate a database.
If you need to access a database multiple times, you should use the Connection object to establish a connection. You can also create a connection by passing a connection string through a Command or Recordset object. However, such connections are only suitable for a single, simple query.
ProgID
Properties
| Property |
Description |
| Attributes |
Sets or returns properties of the Connection object. |
| CommandTimeout |
Indicates the time to wait before terminating an attempt to execute a command and generating an error. |
| ConnectionString |
Sets or returns details used to establish a connection to a data source. |
| ConnectionTimeout |
Indicates the time to wait before terminating an attempt to establish a connection and generating an error. |
| CursorLocation |
Sets or returns the location of the cursor service. |
| DefaultDatabase |
Indicates the default database for the Connection object. |
| IsolationLevel |
Indicates the isolation level for the Connection object. |
| Mode |
Sets or returns the access permissions for the provider. |
| Provider |
Sets or returns the name of the provider for the Connection object. |
| State |
Returns a value describing whether the connection is open or closed. |
| Version |
Returns the ADO version number. |
Methods
| Method |
Description |
| BeginTrans |
Begins a new transaction. |
| Cancel |
Cancels an execution. |
| Close |
Closes a connection. |
| CommitTrans |
Saves any changes and ends the current transaction. |
| Execute |
Executes a query, SQL statement, stored procedure, or provider-specific text. |
| Open |
Opens a connection. |
| OpenSchema |
Returns schema information about the data source from the provider. |
| RollbackTrans |
Cancels any changes made in the current transaction and ends the transaction. |
Events
Note: You cannot handle events using VBScript or JScript (only Visual Basic, Visual C++, and Visual J++ can handle events).
| Event |
Description |
| BeginTransComplete |
Triggered after the BeginTrans operation. |
| CommitTransComplete |
Triggered after the CommitTrans operation. |
| ConnectComplete |
Triggered after a connection begins. |
| Disconnect |
Triggered after a connection ends. |
| ExecuteComplete |
Triggered after a command execution completes. |
| InfoMessage |
Triggered if a warning occurs during a ConnectionEvent operation. |
| RollbackTransComplete |
Triggered after the RollbackTrans operation. |
| WillConnect |
Triggered before a connection begins. |
| WillExecute |
Triggered before a command is executed. |
Collections
| Collection |
Description |
| Errors |
Contains all Error objects for the Connection object. |
| Properties |
Contains all Property objects for the Connection object. |