ActiveConnection プロパティ (ADO)

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

設定と戻り値

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

注釈

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

コマンド

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

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

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

注

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

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

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

Recordset

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

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

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

Recordset オブジェクトの Source プロパティを有効な Command オブジェクト変数に設定した場合、Recordset の ActiveConnection プロパティは、Command オブジェクトの ActiveConnection プロパティの設定を継承します。

注

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

記録

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

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