ActiveConnection プロパティ (ADO)

[アーティクル]
05/30/2023

指定した Command オブジェクト、Recordset オブジェクト、または Record オブジェクトが現在属している Connection オブジェクトを示します。

設定と戻り値

接続が閉じている場合は、接続の定義を含む String 値を設定または返します。接続が開いている場合は、現在の Connection オブジェクトを含む Variant を設定または返します。既定値は、null オブジェクト参照です。 ConnectionString プロパティを参照してください。

注釈

ActiveConnection プロパティを使って、指定した Command オブジェクトが実行される、または指定した Recordset が開かれる Connection オブジェクトを決定します。

コマンド

Command オブジェクトの場合、ActiveConnection プロパティは読み取りと書き込みを実行できます。

開いている Connection オブジェクトや有効な接続文字列にこのプロパティを設定する前に、Command オブジェクトで Execute メソッドを呼び出そうとすると、エラーが発生します。

Connection オブジェクトを ActiveConnection プロパティに代入する場合、オブジェクトは開いている必要があります。閉じた Connection オブジェクトを代入すると、エラーが発生します。

注意

Microsoft Visual Basic で ActiveConnection を Nothing に設定すると、現在の Connection から Command オブジェクトの関連付けが解除され、プロバイダーによってデータソースで関連付けられているすべてのリソースが解放されます。その後、同じ、または別の Connection オブジェクトに Command オブジェクトを関連付けることができます。プロバイダーによっては、最初にプロパティを Nothing に設定しなくても、ある Connection から別の Connection にプロパティ設定を変更できる場合があります。

Command オブジェクトの Parameters コレクションに、プロバイダーによって提供されるパラメーターが含まれている場合、ActiveConnection プロパティを Nothing または別の Connection オブジェクトに設定すると、そのコレクションはクリアされます。手動で Parameter オブジェクトを作成し、それらを使って Command オブジェクトの Parameters コレクションを埋める場合は、ActiveConnection プロパティを Nothing または別の Connection オブジェクトに設定しても、Parameters コレクションはそのまま残ります。

Command オブジェクトが関連付けられている Connection オブジェクトを閉じると、ActiveConnection プロパティが Nothing に設定されます。このプロパティを閉じた Connection オブジェクトに設定すると、エラーが発生します。

レコードセット

開いている Recordset オブジェクト、または Source プロパティが有効な Command オブジェクトに設定されている Recordset オブジェクトの場合、ActiveConnection プロパティは読み取り専用です。それ以外の場合は、読み取りと書き込みを実行できます。

このプロパティは、有効な Connection オブジェクトまたは有効な接続文字列に設定できます。この場合、プロバイダーはこの定義を使用して新しい Connection オブジェクトを作成し、接続を開きます。さらに、プロバイダーはこのプロパティを新しい Connection オブジェクトに設定して、ユーザーが Connection オブジェクトにアクセスして拡張エラー情報を得たり、他のコマンドを実行したりできるようにすることもできます。

Open メソッドの ActiveConnection 引数を使用して Recordset オブジェクトを開くと、その引数の値が ActiveConnection プロパティに継承されます。

Recordset オブジェクトの Source プロパティを有効な Command オブジェクト変数に設定すると、Command オブジェクトの ActiveConnection プロパティの設定が Recordset のActiveConnection プロパティに継承されます。

注意

リモートデータサービスの使用状況 クライアント側の Recordset オブジェクトで使用する場合、このプロパティは、接続文字列か、(Microsoft Visual Basic または Visual Basic、Scripting Edition では) Nothing にのみ設定できます。

レコード

Record オブジェクトが閉じているとき、このプロパティは読み取りと書き込みを実行でき、接続文字列または開いている Connection オブジェクトへの参照を含めることができます。 Record オブジェクトが開いているとき、このプロパティは読み取り専用で、開いている Connection オブジェクトへの参照が含まれます。

Connection オブジェクトは、Record オブジェクトが URL から開かれるときに暗黙的に作成されます。既存の開いている Connection オブジェクトを使用して Record を開くには、このプロパティに Connection オブジェクトを代入するか、Open メソッド呼び出しのパラメーターとして Connection オブジェクトを使用します。 Record が既存の Record または Recordset から開かれている場合、それは自動的に、その Record オブジェクトまたは Recordset オブジェクトの Connection オブジェクトに関連付けられます。