接続オブジェクト (ADO)
適用先: Access 2013、Office 2013
データ ソースに対して開かれている接続を表します。
注釈
Connection オブジェクトは、データ ソースとの固有のセッションを表します。 クライアント/サーバー データベース システムの場合、このオブジェクトは、サーバーへの実際のネットワーク接続に相当します。 プロバイダーがサポートする機能によっては、 Connection オブジェクトの一部のコレクション、メソッド、またはプロパティを使用できない場合があります。
Connection オブジェクトのコレクション、メソッド、およびプロパティを使用すると、次の操作を実行できます。
接続を開く前に、ConnectionString、ConnectionTimeout、および Mode の各プロパティを使用して接続を設定できます。 ConnectionString は Connection オブジェクトの既定のプロパティです。
CursorLocation プロパティをクライアントに設定して、バッチ更新をサポートする Microsoft Cursor Service for OLE DB を呼び出すことができます。
DefaultDatabase プロパティを使用して、接続の既定のデータベースを設定できます。
IsolationLevel プロパティを使用して、接続上で開かれているトランザクションの分離レベルを設定できます。
Provider プロパティを使用して、OLE DB プロバイダーを指定できます。
Execute メソッドを使用して接続上でコマンドを実行し、 CommandTimeout プロパティを使用して実行を設定できます。
注:
[!メモ] Command オブジェクトを使用せずにクエリを実行するには、クエリ文字列を Connection オブジェクトの Execute メソッドに渡します。 ただし、コマンド テキストを永続化して再実行するか、クエリ パラメーターを使用する場合は、 Command オブジェクトが必要となります。
BeginTrans、CommitTrans、RollbackTrans の各メソッドおよび Attributes プロパティを使用して、開いている接続上のトランザクション (プロバイダーがネストされているトランザクションをサポートしている場合は、ネストされているトランザクションも含む) を管理できます。
Errors コレクションを使用して、データ ソースから返されたエラーを調べることができます。
Version プロパティを使用して、使用中の ADO 実装からバージョンを取得できます。
OpenSchema メソッドを使用して、データベースのスキーマ情報を取得できます。
前に定義した他のオブジェクトと無関係に Connection オブジェクトを作成できます。
次に示すように、コマンドやストアド プロシージャを Connection オブジェクト固有のメソッドとして実行できます。
コマンドを Connection オブジェクト固有のメソッドとして実行する
コマンドを実行するには、 Command オブジェクトの Name プロパティを使用して、コマンドに名前を設定します。 Command オブジェクトの ActiveConnection プロパティを該当する接続に設定します。 次に、ステートメントを、コマンド名 ( Connection オブジェクトのメソッド名として)、パラメーター、 Recordset オブジェクト (行を取得する場合) の順に指定して発行します。 Recordset プロパティを設定して、結果の Recordset をカスタマイズします。 例:
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.yourCommandName "parameter", rst
ストアド プロシージャを Connection オブジェクト固有のメソッドとして実行する
ストアド プロシージャを実行するには、ステートメントを、ストアド プロシージャ名 ( Connection オブジェクトのメソッド名として)、パラメーターの順に指定して発行します。 ADO では、パラメーターの種類について最適なものが推測されます。 次に例を示します。
Dim cnn As New ADODB.Connection
...
'Your stored procedure name and any parameters.
cnn.sp_yourStoredProcedureName "parameter"