ActiveConnection プロパティ (ADO)

適用先: Access 2013、Office 2013

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

設定と戻り値

接続が閉じている場合には接続の定義が格納された文字列型 ( String ) の値を、接続が開いている場合には現在の Connection オブジェクトが格納されたバリアント型 ( Variant ) の値を設定または取得します。 既定は、Null オブジェクト参照です。 ConnectionString プロパティの説明を参照してください。

注釈

ActiveConnection プロパティを使用すると、指定された Command オブジェクトを実行する、または指定された Recordset を開く Connection オブジェクトを調べることができます。

command

Command オブジェクトの場合、ActiveConnection プロパティは値の設定も取得も可能です。

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

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

注:

[!メモ] http スキームを使用している URL は、Microsoft OLE DB Provider for Internet Publishing を自動的に呼び出します。 詳細については、「 絶対 URL と相対 URL」を参照してください。