ActiveConnection プロパティ (ADO)

指定したコマンドレコードセット、またはレコードオブジェクトが現在どの接続オブジェクトに属しているかを示します。

設定と戻り値

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

注釈

ActiveConnection プロパティを使用して、指定した コマンド オブジェクトを実行する 接続 オブジェクトを決定します。指定した レコードセット が開かれます。

command

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

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

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

注意

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

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

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

レコードセット

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

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

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

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

注意

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

Record

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

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

注意

Http スキームを使用する Url は、 インターネット公開のために Microsoft OLE DB プロバイダーを自動的に呼び出します。 詳細については、「 絶対 url と相対 url」を参照してください。

適用対象

参照

ActiveConnection、CommandText、CommandTimeout、CommandType、Size、Direction プロパティの例 (VB)
ActiveConnection、CommandText、CommandTimeout、CommandType、Size、Direction プロパティの例 (VC++)
ActiveConnection、CommandText、CommandTimeout、CommandType、Size、Direction プロパティの例 (JScript)
Connection オブジェクト (ADO)
ConnectionString プロパティ (ADO)