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") |