ActiveConnection

(PWS4 IIS4 IIS5)
ActiveConnection — 指定した Command オブジェクト、Recordset オブジェクト、または Record オブジェクトが、現在どの Connection オブジェクトに属するかを示します。

設定値と戻り値

接続が切断された場合は接続定義を格納する文字列型 (String) の値、また、接続が開かれている場合はカレントの Connection オブジェクトを格納したバリアント型 (Variant) の値を設定します。また、値の取得も可能です。既定は Null オブジェクトへの参照です。

説明

指定された Command オブジェクトを実行する Connection オブジェクト、または指定された Recordset を開くための Connection オブジェクトを探すには、ActiveConnection プロパティを使います。

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

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

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

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 オブジェクトにアクセスして詳細エラー情報があるかどうかを調べたり、ほかのコマンドを実行できるようにするためです。

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

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

RDS での使用 クライアント側の Recordset オブジェクトでこのプロパティを使用する場合、このプロパティに設定できるのは、接続文字列、または Nothing (Microsoft Visual Basic または Visual Basic Scripting Edition の場合) だけです。
Record

Record オブジェクトを閉じるとこのプロパティは読み取り/書き込み可能になり、接続文字列または開かれた Connection オブジェクトに対する参照が格納されます。Record オブジェクトを開くとこのプロパティは読み取り専用になり、開かれた Connection オブジェクトに対する参照が格納されます。

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

注意 http スキーマを使用している URL は、Microsoft OLE DB Provider for Internet Publishing を自動的に呼び出します。


Command オブジェクト

データ ソースに対して実行する、特定のコマンドの定義です。

* ActiveConnection
* CommandText
* CommandTimeout
* CommandType
* Dialect
* Name
* Prepared
* State
* Cancel
* CreateParameter
* Execute