サンプルコードで学ぶASP

(PWS4 IIS4 IIS5)
BOF — カレント レコードの位置が Recordset オブジェクトの最初のレコードより前にあることを示します。

構文

object.BOF

パラメータ

戻り値

BOF プロパティは、ブール型 (Boolean) の値を返します。

説明

BOF プロパティと EOF プロパティは、Recordset オブジェクトにレコードが格納されているか、またはレコード間を移動したときに Recordset オブジェクトの制限を超えたかどうかを確認するときに使います。

BOF プロパティは、カレント レコードの位置が最初のレコードより前にある場合は True (-1) を返し、カレント レコードの位置が最初のレコード上またはそれ以降にある場合は False (0) を返します。

BOF プロパティが True の場合、カレント レコードはありません。

レコードを持たない Recordset を開くと、BOF プロパティは True に設定されます (Recordset のこの状態については、RecordCount プロパティを参照してください)。少なくとも 1 つのレコードが格納された Recordset オブジェクトを開くと、最初のレコードがカレント レコードになり、BOF プロパティと EOF プロパティは False になります。

Recordset オブジェクトで最後に残ったレコードを削除しても、カレント レコードの位置を移動するまで BOF プロパティは False のままです。

次の表では、BOF プロパティの設定値の組み合わせと、利用できる Move メソッドの種類を示します。

Move メソッドが使えても、そのメソッドによるレコードの位置が見つかったとは限りません。メソッドが使えるとは、指定された Move メソッドを呼び出してもエラーが発生しなかったことを意味するだけです。

次の表は、さまざまな Move メソッドを呼び出してもレコードの位置が見つからない場合に、BOF プロパティに設定される値を示します。

(PWS4 IIS4 IIS5)
ActiveCommand — 関連付けられた Recordset オブジェクトを作成した Command オブジェクトを示します。

構文

object.ActiveCommand

パラメータ

戻り値

Command オブジェクトを含むバリアント型 (Variant) の値を返します。既定は Null オブジェクトへの参照です。

説明

ActiveCommand プロパティは読み取り専用です。

Command オブジェクトを使わずにカレント Recordset を作成する場合、Null オブジェクトへの参照が返されます。

Recordset オブジェクトの結果しか得られない場合、このプロパティを使い、関連付けられた Command オブジェクトを検索します。

(PWS4 IIS4 IIS5)
AbsolutePosition — Recordset オブジェクト内のカレント レコードの位置を示します。

構文

object.AbsolutePosition

パラメータ

設定値と戻り値

1 から Recordset オブジェクトのレコード数 (RecordCount) までの長整数型 (Long) の値を設定します。また、値の取得も可能です。あるいは、PositionEnum の値の 1 つを返します。

説明

AbsolutePosition プロパティを使うと、Recordset オブジェクト内の位置に基づいて特定のレコードに移動したり、カレントレコードの位置を決定することができます。プロバイダが必要な機能をサポートしていないと、このプロパティは利用できません。

AbsolutePage プロパティと同様に、AbsolutePosition の値は 1 から始まります。また、カレント レコードが Recordset の最初のレコードの場合、値は 1 になります。Recordset のレコードの総数を調べるには、RecordCount プロパティを確認します。

AbsolutePosition プロパティを設定すると、現在のキャッシュに存在するレコードが対象であっても、指定のレコードで始まる新しいレコードグループがキャッシュに再読み込みされます。このレコード グループのサイズは CacheSize プロパティで決まります。

注意 AbsolutePosition プロパティで、レコード番号の代用はできません。レコードの位置は、上位のレコードを削除すると変更されます。また、Recordset オブジェクトを再びクエリしたり開いたときに、レコードが AbsolutePosition の値と同じになるとは限りません。所定の位置を保持し、そして戻るにはブックマークを使います。ブックマークは、すべての型の Recordset オブジェクト間で位置を決定できる唯一の方法です。

(PWS4 IIS4 IIS5)
AbsolutePage — カレント レコードがあるページを示します。

構文

object.AbsolutePage

パラメータ

設定値と戻り値

1 から Recordset オブジェクトのページ数 (PageCount) までの値を長整数型 (Long) に設定します。また、値の取得も可能です。あるいは、PositionEnum の値の 1 つを返します。

説明

カレント レコードのページ番号を確認するには、AbsolutePage プロパティを使います。Recordset オブジェクトを一連のページに論理的に分割するには、PageSize プロパティを使用します。各ページには PageSize の設定値に等しい数のレコードが存在します。ただし、最終ページのレコード数は PageSize の値より小さい場合があります。プロバイダが必要な機能をサポートしていないと、このプロパティは利用できません。

AbsolutePosition プロパティと同様に AbsolutePage の値は 1 から始まります。また、カレント レコードが Recordset の最初のレコードの場合、値は 1 になります。特定のページの最初のレコードに移動するには、このプロパティを設定します。総ページ数を調べるには PageCount プロパティを確認します。

テーブルのレコード セット全体、またはコマンドの実行によって返された結果を表します。Recordset オブジェクトでは、常にレコードセット内の 1 つのレコードのみをカレント レコードとして参照します。

* AbsolutePage
* AbsolutePosition
* ActiveCommand
* BOF
* Bookmark
* CacheSize
* CursorLocation
* CursorType
* EditMode
* EOF
* Filter
* Index
* LockType
* MaxRecords
* PageCount
* PageSize
* RecordCount
* Sort
* Source
* State
* Status
* StayInSync
* AddNew
* Cancel
* CancelBatch
* CancelUpdate
* Clone
* Close
* Delete
* CompareBookmarks
* Find
* GetRows
* GetString
* Move
* MoveFirst
* MoveLast
* MoveNext
* MovePrevious
* NextRecordset
* Open
* Requery
* Save
* Seek
* Supports
* Update
* UpdateBatch

(PWS4 IIS4 IIS5)
Close — 開いているオブジェクトおよびそれに従属するすべてのオブジェクトを閉じます。

構文

object.Close

パラメータ

説明

Close メソッドを使って、Connection オブジェクト、Record オブジェクト、Recordset オブジェクト、または Stream オブジェクトを閉じ、関連するすべてのシステムリソースを解放します。オブジェクトを閉じてもメモリからは削除されず、プロパティ設定を変更してもう一度開くことができます。メモリからオブジェクトを完全に削除するには、オブジェクトを閉じて、オブジェクト変数を Nothing (Visual Basic の場合) に設定します。

Close メソッドを使って Recordset オブジェクト、Record オブジェクト、または Stream オブジェクトを閉じると、関連するデータと、そのデータに対するこのオブジェクトからの排他アクセスがすべて解放されます。その後で Open メソッドを呼び出して、同じ属性または更新された属性を持つオブジェクトを再度開くことができます。

Recordset オブジェクトが閉じているときに、開いているカーソルを必要とするメソッドを呼び出すと、エラーが発生します。

即時更新モードで編集しているときに Close メソッドを呼び出すと、エラーが発生します。この場合は、先に Update メソッドまたは CancelUpdate メソッドを呼び出してください。バッチ更新モードの実行中に Recordset オブジェクトを閉じると、最後に UpdateBatch メソッドを実行した後に行われた変更がすべて失われます。

Clone メソッドを使って開いている Recordset オブジェクトのコピーを作成した場合、元のオブジェクトまたはクローンを閉じてもほかのコピーには影響しません。

(PWS4 IIS4 IIS5)
Cancel — 非同期メソッド呼び出しのうち、保留中のものの実行をキャンセルします。

構文

object.Cancel

パラメータ

設定値と戻り値

Cancel メソッドを使って、非同期メソッド (adAsyncConnect、adAsyncExecute、または adAsyncFetch のオプションを指定して呼び出すメソッド) の呼び出しの実行を中止します。

説明

次の表は、各種のオブジェクトで Cancel メソッドを使用したときに中止される操作です。

オブジェクトを開いているか閉じているか、データ ソースに接続中か、コマンドを実行中か、またはデータを取得中かどうかを表します。

PWS4 IIS4 IIS5)
State — 対象になるすべてのオブジェクトについて、そのオブジェクトが開いているか、または閉じているかを示します。
非同期メソッドを実行している対象の全オブジェクトについて、そのオブジェクトが現在、接続、実行、取得のどの状態であるかを示します。

構文

object.State

パラメータ

戻り値

ObjectStateEnum 値となる長整数型 (Long) の値を返します。既定値は adStateClosed です。

説明

State プロパティを使えば、オブジェクトの現在の状態をいつでも調べることができます。

オブジェクトの State プロパティの値は組み合わせることができます。たとえば、ステートメントが実行中のときは、プロパティの値は adStateOpen と adStateExecuting の組み合わせになります。

State プロパティは読み取り専用です。

(PWS4)
Source — Record で表されるデータ ソースまたはオブジェクトを示します。

構文

object.Source

パラメータ

設定値と戻り値

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 オブジェクトが開いているときは読み取り専用になります。