ADO Recordsetオブジェクト


インスタンス

GetRows
この例では、GetRows メソッドの使用方法をデモンストレーションします。


Recordset オブジェクト

ADO Recordset オブジェクトは、データベーステーブルからのレコードセットを格納するために使用されます。Recordset オブジェクトは、レコードと列(フィールド)で構成されます。

ADO では、このオブジェクトはデータベースのデータを操作するために最も重要で最も一般的に使用されるオブジェクトです。

ProgID

set objRecordset=Server.CreateObject("ADODB.recordset")

Recordset を最初に開くとき、現在のレコードポインタは最初のレコードを指し、BOF および EOF プロパティは False です。レコードがない場合、BOF および EOF プロパティは True です。

Recordset オブジェクトは、2 種類の更新タイプをサポートできます:

    即時更新 - Update メソッドを呼び出すと、すべての変更が直ちにデータベースに書き込まれます。 バッチ更新 - provider は複数の変更をキャッシュし、UpdateBatch メソッドを使用してこれらの変更をデータベースに転送します。

ADO では、4 つの異なるカーソル(ポインタ)タイプが定義されています:

  • 動的カーソル - 他のユーザーによる追加、変更、削除を表示できます。
  • キーセットカーソル - 動的カーソルに似ていますが、他のユーザーによる追加を表示できない点と、他のユーザーが削除したレコードへのアクセスを防ぐ点が異なります。他のユーザーによるデータ変更は引き続き表示されます。
  • 静的カーソル - レコードセットの静的コピーを提供し、データの検索やレポートの生成に使用できます。さらに、他のユーザーによる追加、変更、削除は表示されません。クライアント側の Recordset オブジェクトを開くとき、これは唯一許可されるカーソルタイプです。
  • 前方のみカーソル - Recordset 内での前方スクロールのみが許可されます。さらに、他のユーザーによる追加、変更、削除は表示されません。

カーソルのタイプは、CursorType プロパティまたは Open メソッドの CursorType パラメータで設定できます。

注釈:すべてのプロバイダー(providers)が Recordset オブジェクトのすべてのメソッドとプロパティをサポートしているわけではありません。


プロパティ

プロパティ 説明
AbsolutePage Recordset オブジェクトのページ番号を指定する値を設定または返します。
AbsolutePosition Recordset オブジェクト内の現在のレコードの順序位置(シーケンス番号位置)を指定する値を設定または返します。
ActiveCommand Recordset オブジェクトに関連付けられた Command オブジェクトを返します。
ActiveConnection 接続が閉じられている場合は接続の定義を設定または返し、接続が開いている場合は現在の Connection オブジェクトを設定または返します。
BOF 現在のレコード位置が最初のレコードより前にある場合は true を返し、そうでない場合は false を返します。
Bookmark ブックマークを設定または返します。このブックマークは現在のレコードの位置を保存します。
CacheSize キャッシュできるレコードの数を設定または返します。
CursorLocation カーソルサービスの場所を設定または返します。
CursorType Recordset オブジェクトのカーソルタイプを設定または返します。
DataMember DataSource プロパティによって参照されるオブジェクトから取得するデータメンバーの名前を設定または返します。
DataSource Recordset オブジェクトとして表されるデータを含むオブジェクトを指定します。
EditMode 現在のレコードの編集状態を返します。
EOF 現在のレコード位置が最後のレコードより後にある場合は true を返し、そうでない場合は false を返します。
Filter Recordset オブジェクト内のデータに対するフィルターを返します。
Index Recordset オブジェクトの現在のインデックスの名前を設定または返します。
LockType Recordset 内のレコードを編集するときに、ロックタイプを指定する値を設定または返します。
MarshalOptions どのレコードがサーバーに返されるかを指定する値を設定または返します。
MaxRecords クエリから返される Recordset オブジェクトの最大レコード数を設定または返します。
PageCount Recordset オブジェクト内のデータページ数を返します。
PageSize Recordset オブジェクトの単一ページで許可される最大レコード数を設定または返します。
RecordCount Recordset オブジェクト内のレコード数を返します。
Sort Recordset の並べ替え基準となる 1 つ以上のフィールド名を設定または返します。
Source 文字列値または Command オブジェクト参照を設定するか、文字列値を返します。この値は Recordset オブジェクトのデータソースを示します。
State Recordset オブジェクトが開いている、閉じている、接続中、実行中、またはデータ取得中かどうかを示す値を返します。
Status バッチ更新またはその他の大量操作に関する現在のレコードの状態を返します。
StayInSync 親レコードの位置が変更されたときに、子レコードへの参照が変更されるかどうかを設定または返します。

メソッド

メソッド 説明
AddNew 新しいレコードを作成します。
Cancel 実行をキャンセルします。
CancelBatch バッチ更新をキャンセルします。
CancelUpdate Recordset オブジェクトのレコードに対する変更をキャンセルします。
Clone 既存の Recordset のコピーを作成します。
Close Recordset を閉じます。
CompareBookmarks 2 つのブックマークを比較します。
Delete レコードまたはレコードのグループを削除します。
Find Recordset 内で指定された条件を満たすレコードを検索します。
GetRows 複数のレコードを Recordset オブジェクトから 2 次元配列にコピーします。
GetString Recordset を文字列として返します。
Move Recordset オブジェクト内でレコードポインタを移動します。
MoveFirst レコードポインタを最初のレコードに移動します。
MoveLast レコードポインタを最後のレコードに移動します。
MoveNext レコードポインタを次のレコードに移動します。
MovePrevious レコードポインタを前のレコードに移動します。
NextRecordset 一連のコマンドを実行して現在の Recordset オブジェクトをクリアし、次の Recordset を返します。
Open テーブルのレコード、クエリの結果、または保存された Recordset へのアクセスを提供するデータベース要素を開きます。
Requery オブジェクトの基になっているクエリを再実行して、Recordset オブジェクト内のデータを更新します。
Resync 元のデータベースから現在の Recordset 内のデータを更新します。
Save Recordset オブジェクトを file または Stream オブジェクトに保存します。
Seek Recordset のインデックスを検索して、指定された値に一致する行をすばやく特定し、それを現在の行にします。
Supports Recordset オブジェクトが特定のタイプの機能をサポートしているかどうかを定義するブール値を返します。
Update Recordset オブジェクト内の単一のレコードに対するすべての変更を保存します。
UpdateBatch Recordset 内のすべての変更をデータベースに保存します。バッチ更新モードで使用してください。

イベント

注意: VBScript または JScript で処理することはできません(Visual Basic、Visual C++、および Visual J++ 言語のみがイベントを処理できます)。

イベント 説明
EndOfRecordset Recordset の末尾を超えて行に移動しようとしたときにトリガーされます。
FetchComplete 非同期操作内のすべてのレコードが読み取られた後にトリガーされます。
FetchProgress 非同期操作中に定期的にトリガーされ、読み取られたレコード数を報告します。
FieldChangeComplete Field オブジェクトの値が変更されたときにトリガーされます。
MoveComplete Recordset 内の現在位置が変更された後にトリガーされます。
RecordChangeComplete レコードが変更された後にトリガーされます。
RecordsetChangeComplete Recordset が変更された後にトリガーされます。
WillChangeField Field オブジェクトの値が変更される前にトリガーされます。
WillChangeRecord レコードが変更される前にトリガーされます。
WillChangeRecordset Recordset が変更される前にトリガーされます。
WillMove Recordset 内の現在位置が変更される前にトリガーされます。

コレクション

コレクション 説明
Fields この Recordset オブジェクト内の Field オブジェクトの数を示します。
Properties Recordset オブジェクト内のすべての Property オブジェクトを含みます。

Fields コレクションのプロパティ

プロパティ 説明
Count

fields コレクション内の項目の数を返します。0 から始まります。

例:

countfields = rs.Fields.Count
Item(named_item/number)

fields コレクション内の指定された項目を返します。

例:

itemfields = rs.Fields.Item(1)
或者    
itemfields = rs.Fields.Item("Name")

Properties コレクションのプロパティ

プロパティ 説明
Count

プロパティコレクション内の項目数を返します。0から始まります。

例:

countprop = rs.Properties.Count
Item(named_item/number)

プロパティコレクション内の指定された項目を返します。

例:

itemprop = rs.Properties.Item(1)
或者
itemprop = rs.Properties.Item("Name")
その他の拡張