サンプルコードで学ぶASP

(PWS4 IIS4 IIS5)
Provider — Connection オブジェクトのプロバイダ名を示します。

設定値と戻り値

プロバイダ名を示す文字列型 (String) の値を設定します。また、値の取得も可能です。

説明

接続用のプロバイダ名を設定または取得するには、Provider プロパティを使います。このプロパティは、ConnectionString プロパティまたは Open メソッドの ConnectionString 引数の内容によって設定することもできます。ただし、Open メソッドの呼び出し中に 1 つ以上の場所でプロバイダを指定すると、予期しない結果が生じる可能性があります。プロバイダが指定されない場合、プロパティは既定値である MSDASQL (Microsoft OLE DB Provider for ODBC) になります。

Provider プロパティは、接続が閉じている場合は読み取り/書き込み可能になり、接続が開いている場合は読み取り専用になります。設定値は、Connection オブジェクトを開くか、Connection オブジェクトの Properties コレクションにアクセスするまで有効になりません。設定が無効な場合、エラーが発生します。

(PWS4 IIS4 IIS5)
Mode — Connection オブジェクト、Record オブジェクト、または Stream オブジェクトで使用可能なデータ変更権限を示します。

設定値と戻り値

ConnectModeEnum の値を設定します。また、値の取得も可能です。Connection の既定値は adModeUnknown です。Record オブジェクトの既定値は adModeRead です。基になるソースに関連付けられている Stream (URL により、ソース、または Record の既定 Stream として開かれたもの) の既定値は、adModeRead です。基になるソースに関連付けられていない (メモリ内でインスタンス作成された) Stream の既定値は、adModeUnknown です。

説明

現在の接続でプロバイダが使用しているアクセス権は、Mode プロパティを使って設定または取得します。Mode プロパティは、Connection オブジェクトが閉じている場合のみ設定できます。

Stream オブジェクトでは、アクセス モードを指定しない場合、Stream オブジェクトを開くときに使うソースのモードが継承されます。たとえば、Record オブジェクトから Stream を開くと、既定では Record と同じモードで開きます。

このプロパティは、オブジェクトが閉じているときは読み取り/書き込み可能になり、オブジェクトが開いているときは読み取り専用になります。

RDS での使用 クライアント側の Connection オブジェクトで使う場合、Mode プロパティは adModeUnknown にのみ設定できます。

(PWS4 IIS4 IIS5)
IsolationLevel — Connection オブジェクトの分離レベルを示します。

設定値と戻り値

プロバイダで使用可能なデータベース名を評価する文字列型 (String) の値を設定します。また、値の取得も可能です。

説明

IsolationLevel プロパティでは、Connection オブジェクトの分離レベルを設定します。設定値は、次に BeginTrans メソッドを呼び出すまで有効になりません。要求した分離レベルが使えない場合、プロバイダはその次に高い分離レベルを返します。

IsolationLevel プロパティは読み取り/書き込み可能になっています。

RDS での使用 クライアント側の Connection オブジェクトで使う場合、IsolationLevel プロパティは adXactUnspecified にのみ設定できます。

ユーザーは、クライアント側のキャッシュ上の接続されていない Recordset オブジェクトで作業するため、マルチユーザーの場合は問題になることがあります。たとえば、2 人のユーザーが同じレコードを更新しようとした際、RDS は単純に先に操作を行ったユーザーの更新を受け付けます。2 番目のユーザーの更新要求はエラーになって失敗します。

(PWS4 IIS4 IIS5)
DefaultDatabase — Connection オブジェクトの既定のデータベースを示します。

設定値と戻り値

プロバイダで使用可能なデータベース名を評価する文字列型 (String) の値を設定します。また、値の取得も可能です。

説明

特定の Connection オブジェクトの既定のデータベース名を設定または取得するには、DefaultDatabase プロパティを使います。

既定のデータベースがある場合、そのデータベース上のオブジェクトにアクセスする SQL 文が不適切な場合があります。DefaultDatabase プロパティで指定されたデータベース以外のデータベース上のオブジェクトにアクセスするには、オブジェクト名を目的のデータベース名で修飾する必要があります。接続時に、プロバイダは DefaultDatabase プロパティに既定のデータベース情報を書き込みます。プロバイダの中には接続時に 1 つのデータベースしかアクセスできないものがあり、その場合、DefaultDatabase プロパティは変更できません。

データ ソースとプロバイダによっては、この機能をサポートせず、エラーまたは空文字列を返す場合があります。

RDS での使用 このプロパティは、クライアント側の Connection オブジェクトでは使用できません。

(PWS4 IIS4 IIS5)
CursorLocation — カーソル サービスの場所を示します。

設定値と戻り値

CursorLocationEnum 値のいずれか 1 つに設定可能な長整数型 (Long) の値を設定します。また、値の取得も可能です。

説明

このプロパティで、プロバイダにアクセス可能なさまざまなカーソル ライブラリの中からカーソル サービスを選択します。通常は、クライアント側カーソル ライブラリ、またはサーバー側カーソル ライブラリから選択します。

このプロパティ設定は、プロパティが設定された後に確立された接続のみに作用します。CursorLocation プロパティを変更しても既存の接続には影響しません。

Execute メソッドが返すカーソルは、この設定を継承します。Recordset オブジェクトは関連付けられた接続からこの設定を自動的に継承します。

このプロパティは、Connection または閉じている Recordset 上では読み取り/書き込み可能で、開いている Recordset 上では読み取り専用です。

RDS での使用 クライアント側の Recordset オブジェクトまたは Connection オブジェクトで使う場合、CursorLocation プロパティは adUseClient にのみ設定できます。

(PWS4 IIS4 IIS5)
ConnectionTimeout — 接続操作を中止して、エラーを発生させるまでの待機時間を示します。

設定値と戻り値

接続が開くまでの待機時間を秒単位で示す長整数型 (Long) の値を設定します。また、値の取得も可能です。既定値は 15 です。

説明

C ネットワーク トラフィックやサーバーの過度の使用が原因で接続に時間がかかる場合、接続を中止する必要があります。この場合は Connection オブジェクトで ConnectionTimeout プロパティを使用します。接続が確立される前に ConnectionTimeout プロパティで設定した時間が経過した場合、エラーが発生して接続が取り消されます。このプロパティに 0 を設定した場合は、接続が確立されるまで無限に待機します。コードを書き込むプロバイダが、ConnectionTimeout 機能をサポートしていることを確認してください。

接続が閉じている場合、ConnectionTimeout プロパティは読み取り/書き込み可能になっています。接続が開いている場合は読み取り専用になります。

(PWS4 IIS4 IIS5)
ConnectionString — データ ソースとの接続に必要な情報を示します。

設定値と戻り値

文字列型 (String) の値を設定します。また、値の取得も可能です。

説明

ConnectionString プロパティを使って、セミコロンで区切られた一連の argument = value ステートメントを含む詳細な接続文字列を渡してデータ ソースを指定します。

ADO は ConnectionString プロパティで 5 種類の引数をサポートしています。その他の引数は ADO で処理されずに直接プロバイダに渡されます。ADO がサポートする引数を次に示します。

パラメータ

ConnectionString プロパティは、Open メソッドの ConnectionString 引数に使用された値を自動的に継承します。したがって、Open メソッドの呼び出し中に現在の ConnectionString プロパティを上書きすることができます。

File Name 引数により関連のあるプロバイダが呼び出されるため、Provider 引数と File Name 引数の両方を渡すことはできません。

接続が閉じている場合の ConnectionString プロパティは読み取り/書き込み可能になっていますが、接続が開いている場合は読み取り専用になります。

ConnectionString プロパティで引数が重複しても無視されます。引数では、最後のインスタンスが適用されます。

RDS での使用 クライアント側の Connection オブジェクトで使う場合、ConnectionString プロパティに指定できるのは Remote Provider パラメータと Remote Server パラメータだけです。

(PWS4 IIS4 IIS5)
CommandTimeout — 接続操作を中止して、エラーを発生させるまでの待機時間を示します。

設定値と戻り値

接続が開くまでの待機時間を秒単位で示す長整数型 (Long) の値を設定します。また、値の取得も可能です。既定値は 15 です。

説明

ネットワーク トラフィックやサーバーの過度の使用が原因で接続に時間がかかる場合、接続を中止する必要があります。この場合は Connection オブジェクトで ConnectionTimeout プロパティを使用します。接続が確立される前に ConnectionTimeout プロパティで設定した時間が経過した場合、エラーが発生して接続が取り消されます。このプロパティに 0 を設定した場合は、接続が確立されるまで無限に待機します。コードを書き込むプロバイダが、ConnectionTimeout 機能をサポートしていることを確認してください。

接続が閉じている場合、ConnectionTimeout プロパティは読み取り/書き込み可能になっています。接続が開いている場合は読み取り専用になります。

CommandTimeout(Command オブジェクト) も参照ください。

(PWS4 IIS4 IIS5)
Attributes — オブジェクトの 1 つ以上の特性を示します。

設定値と戻り値

長整数型 (Long) の値を設定します。また、値の取得も可能です。

Connection オブジェクトの場合、Attributes プロパティは読み取り/書き込み可能で、その値は 1 つ以上の XactAttributeEnum 値の和になります。既定値は 0 です。

Parameter オブジェクトの場合、Attributes プロパティは読み取り/書き込み可能で、その値は 1 つ以上の ParameterAttributesEnum 値の和になります。既定値は adParamSigned です。

Field オブジェクトの場合、Attributes プロパティは 1 つ以上の FieldAttributeEnum 値の和になります。通常は読み取り専用ですが、Record の Fields コレクションに追加された新規 Field オブジェクトの場合、Field の Value プロパティが指定されていて、データ プロバイダが Fields コレクションの Update メソッドを呼び出して新規 Field の追加に成功した場合に限り、Attributes は読み取り/書き込み可能になります。

Property オブジェクトの場合、Attributes プロパティは読み取り専用で、その値は、1 つ以上の PropertyAttributesEnum 値の和になります。

説明

Connection オブジェクト、Parameter オブジェクト、Field オブジェクト、または Property オブジェクトの特性の設定と取得には、Attributes プロパティを使います。

複数の属性を設定する場合、該当する定数の和を設定することができます。同時に設定できない定数の和をプロパティ値に設定すると、エラーが発生します。

RDS での使用 このプロパティは、クライアント側の Connection オブジェクトでは使用できません。