(PWS4 IIS4 IIS5)
Cancel — 非同期メソッド呼び出しのうち、保留中のものの実行をキャンセルします。
object.Cancel
| object | Record オブジェクトを指定します。 |
|---|
Cancel メソッドを使って、非同期メソッド (adAsyncConnect、adAsyncExecute、または adAsyncFetch のオプションを指定して呼び出すメソッド) の呼び出しの実行を中止します。
次の表は、各種のオブジェクトで Cancel メソッドを使用したときに中止される操作です。
| object に指定するオブジェクト | 最後の非同期呼び出しが中止されるメソッド |
|---|---|
| Command | Execute |
| Connection | Execute または Open |
| Record | CopyRecord、DeleteRecord、MoveRecord、または Open |
| Recordset | Open |
| Stream | Open |
オブジェクトを開いているか閉じているか、データ ソースに接続中か、コマンドを実行中か、またはデータを取得中かどうかを表します。
| 定数 | 値 | 説明 |
|---|---|---|
| adStateClosed | 0 | オブジェクトが閉じていることを示します。 |
| adStateOpen | 1 | オブジェクトが開いていることを示します。 |
| adStateConnecting | 2 | オブジェクトが接続していることを示します。 |
| adStateExecuting | 4 | オブジェクトがコマンドを実行中であることを示します。 |
| adStateFetching | 8 | オブジェクトの行が取得されていることを示します。 |
PWS4 IIS4 IIS5)
State — 対象になるすべてのオブジェクトについて、そのオブジェクトが開いているか、または閉じているかを示します。
非同期メソッドを実行している対象の全オブジェクトについて、そのオブジェクトが現在、接続、実行、取得のどの状態であるかを示します。
object.State
| object | Record オブジェクトを指定します。 |
|---|
ObjectStateEnum 値となる長整数型 (Long) の値を返します。既定値は adStateClosed です。
State プロパティを使えば、オブジェクトの現在の状態をいつでも調べることができます。
オブジェクトの State プロパティの値は組み合わせることができます。たとえば、ステートメントが実行中のときは、プロパティの値は adStateOpen と adStateExecuting の組み合わせになります。
State プロパティは読み取り専用です。
(PWS4)
Source — Record で表されるデータ ソースまたはオブジェクトを示します。
object.Source
| object | Record オブジェクトを指定します。 |
|---|
Record が表すエンティティを示す文字列型 (String) の値を設定します。また、値の取得も可能です。
Source プロパティは、Record オブジェクトの Open メソッドの Source 引数を返します。絶対 URL または相対 URL の文字列を格納します。絶対 URL では、ActiveConnection プロパティを設定せずに Record オブジェクトを直接開くことができます。この場合、暗黙の Connection オブジェクトが作成されます。
Source プロパティには、開いている Recordset に対する参照も格納できます。この参照では、Recordset の現在の行を表す Record オブジェクトが開かれます。
また、Source プロパティには、プロバイダから 1 つのデータ行を返す Command オブジェクトへの参照も格納することができます。
ActiveConnection プロパティも設定するときは、接続範囲内にあるオブジェクトを Source プロパティで指定します。たとえば、ツリー構造の名前空間では、Source プロパティに絶対 URL が指定されている場合、接続文字列内の URL で指定したノードの適用範囲内にあるノードを指定している必要があります。Source プロパティに相対 URL が指定されている場合、ActiveConnection プロパティで設定されたコンテキスト内で有効となります。
Source プロパティは、Record オブジェクトが閉じているときは読み取り/書き込み可能になり、Record オブジェクトが開いているときは読み取り専用になります。
Record オブジェクトの種類を表します。
| 定数 | 値 | 説明 |
|---|---|---|
| adSimpleRecord | 0 | “単一の” レコード (子ノードがないレコード) を表します。 |
| adCollectionRecord | 1 | “コレクション” レコード (子ノードがあるレコード) を表します。 |
| adRecordUnknown | -1 | この Record の型が不明であることを表します。 |
| adStructDoc | 2 | COM 構造化ドキュメントを表す特殊な “コレクション” レコードを表します。 |
(PWS4 IIS4 IIS5)
RecordType — Record オブジェクトのタイプを示します。
object.RecordType
| object | Record オブジェクトを指定します。 |
|---|
RecordTypeEnum 値を返します。
RecordType プロパティは読み取り専用です。
(PWS4 IIS4 IIS5)
Mode — Connection オブジェクト、Record オブジェクト、または Stream オブジェクトで使用可能なデータ変更権限を示します。
object.Mode
| object | Record オブジェクを指定します。 |
|---|
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)
ActiveConnection — 指定した Command オブジェクト、Recordset オブジェクト、または Record オブジェクトが、現在どの Connection オブジェクトに属するかを示します。
object.ActiveConnection
| object | Record オブジェクを指定します。 |
|---|
接続が切断された場合は接続定義を格納する文字列型 (String) の値、また、接続が開かれている場合はカレントの Connection オブジェクトを格納したバリアント型 (Variant) の値を設定します。また、値の取得も可能です。既定は Null オブジェクトへの参照です。
Record オブジェクトを閉じるとこのプロパティは読み取り/書き込み可能になり、接続文字列または開かれた Connection オブジェクトに対する参照が格納されます。Record オブジェクトを開くとこのプロパティは読み取り専用になり、開かれた Connection オブジェクトに対する参照が格納されます。
URL から Record オブジェクトを開くと、Connection オブジェクトが無条件で作成されます。既存の開かれた Connection オブジェクトで Record を開くには、Connection オブジェクトをこのプロパティに割り当てるか、Open メソッドを呼び出す際のパラメータとして Connection オブジェクトを使用します。既存の Record や Recordset から開いた Record は、Record オブジェクトや Recordset オブジェクトの Connection オブジェクトに自動的に関連付けられます。
Recordset の行、またはファイル システム内のディレクトリやファイルを表します。
* ActiveConnection
* Mode
* RecordType
* Source
* State
* Cancel
* Close
(PWS4 IIS4 IIS5)
Refresh — コレクションのオブジェクトを更新し、プロバイダから使用可能な、プロバイダに固有のオブジェクトを反映します。
collection.Refresh
| collection | Properties コレクションを指定します。 |
|---|
オブジェクトへの参照を返します。
Refresh メソッドは、どのコレクションから呼び出すかによって異なるタスクを実行します。
オブジェクトの中には、Properties コレクションで Refresh メソッドを使用すると、プロバイダが公開するダイナミックプロパティによって Properties コレクションを更新するものがあります。これらのプロパティは、ADO でサポートされている組み込みプロパティにはない、プロバイダに固有の機能に関する情報を提供します。