サンプルコードで学ぶASP

(PWS4 IIS4 IIS5)
CursorType — Recordset オブジェクトで使用されるカーソルの種類を示します。

構文

object.CursorType = value

パラメータ

設定値と戻り値

CursorTypeEnum の値を設定します。また、値の取得も可能です。既定値は adOpenForwardOnly です。

説明

CursorType プロパティでは、Recordset オブジェクトを開くときに使うカーソルの種類を指定します。

CursorLocation プロパティに adUseClient が設定されている場合は、adOpenStatic の設定だけがサポートされます。サポートされていない値が設定された場合でも、エラーは発生しません。サポートされている CursorType のうち、一番近い値で代用されます。

プロバイダが要求したカーソルの種類をサポートしていない場合は、ほかのカーソルの種類が返ります。Recordset オブジェクトが開いているときには、CursorType プロパティは実際に使用されているカーソルの種類に合わせて変更されます。返されたカーソル特有の機能を調べるには、Supports メソッドを使用します。Recordset を閉じると、CursorType プロパティは元の設定値に戻ります。

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

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

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

構文

object.CursorLocation = value

パラメータ

設定値と戻り値

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

説明

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

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

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

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

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

(PWS4 IIS4 IIS5)
CacheSize — ローカル メモリにキャッシュされた Recordset オブジェクトのレコード数を示します。

構文

object.CacheSize

パラメータ

設定値と戻り値

0 より大きい長整数型 (Long) の値を設定します。また、値の取得も可能です。既定値は 1 です。

説明

CacheSize プロパティを使用して、プロバイダからローカル メモリに一度に取り込むレコード数を制御します。たとえば、CacheSize が 10 の場合、最初に Recordset オブジェクトが開くと、プロバイダは最初の 10 個のレコードをローカルメモリに取り込みます。Recordset オブジェクトを移動する間、プロバイダはローカル メモリバッファからデータを返します。キャッシュ内の最後のレコードを通過すると、プロバイダは次の 10 個のレコードをデータソースからキャッシュに取り込みます。

注意 CacheSize は、プロバイダ固有の Maximum Open Rows プロパティ (Recordset オブジェクトの Properties コレクション内) に基づいた値です。Maximum Open Rows より大きな CacheSize を設定することはできません。プロバイダが開くことのできる行数を修正するには、Maximum Open Rows を設定します。

CacheSize の値は、Recordset オブジェクトが開いている間に変更できますが、変更した値は、次にデータ ソースからキャッシュへ取り込むレコード数に対してのみ適用されます。プロパティ値を変更しただけでは、現在のキャッシュの内容は変更されません。

取り込めるレコード数が CacheSize の指定値より少なくても、プロバイダは残りのレコードを返し、エラーにはなりません。

CacheSize プロパティは 0 には設定できません。エラーになります。

ほかのユーザーがソース データを同時に変更しても、キャッシュから取り込まれたレコードには反映されません。キャッシュに格納されているすべてのデータを強制的に更新するには、Resync メソッドを使用します。

CacheSize に 1 を超える値を設定して、レコードを取得した後に削除を行った場合、移動メソッド (Move、MoveFirst、MoveLast、MoveNext、MovePrevious) を実行すると、削除レコードに移動します。最初のフェッチ後の削除は、削除された行からデータ値にアクセスするまで、データキャッシュには反映されません。ただし、CacheSize に 1 を設定すると、削除行をフェッチできなくなるのでこの問題は解消できます。

(PWS4 IIS4 IIS5)
Bookmark — Recordset オブジェクトのカレント レコードを一意に識別するブックマークを示します。または、Recordset オブジェクトのカレント レコードを、有効なブックマークで識別されるレコードに設定します。

構文

object.Bookmark

パラメータ

設定値と戻り値

有効なブックマークとして評価されるバリアント型 (Variant) の式を設定します。また、値の取得も可能です。

説明

Bookmark プロパティを使ってカレント レコードの位置を保存し、そのレコードにいつでも戻ることができます。ブックマークは、ブックマーク機能をサポートする Recordset オブジェクトでのみ利用できます。

Recordset オブジェクトを開くとき、各レコードには固有のブックマークが割り当てられます。カレント レコードのブックマークを保存するには、Bookmark プロパティの値を変数に代入します。ほかのレコードに移動した後、ブックマークを保存したレコードにすぐに戻るには、Recordset オブジェクトの Bookmark プロパティをその変数に設定します。

ブックマーク値を参照できない場合があります。たとえば、同じレコードを参照するブックマークであっても、異なる値を持つ場合があるため、ブックマークの値を直接比較出来るとは限りません。

Clone メソッドを使って Recordset オブジェクトのコピーを作成した場合、元と複製の Recordset オブジェクトの Bookmark プロパティの設定値は同じになるため、同じように使用できます。ただし、同じソースまたはコマンドから作成されていても、異なる Recordset オブジェクトからのブックマークに互換性はありません。

RDS での使用 クライアント側 Recordset オブジェクトでは、Bookmark プロパティは常に利用できます。

(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 オブジェクトのコピーを作成した場合、元のオブジェクトまたはクローンを閉じてもほかのコピーには影響しません。