例
GETROWS
この例では、GetRowsメソッドを使用する方法を示します。
レコードセットオブジェクト
ADOレコードセットオブジェクトは、データベーステーブルからのレコードのセットを保持するために使用されます。 Recordsetオブジェクトは、レコードと列から成る(fields) 。
ADOでは、このオブジェクトは最も重要であり、一つは、データベースからデータを操作するために最も頻繁に使用されます。
プログラムID
set objRecordset=Server.CreateObject("ADODB.recordset")
あなたが最初のレコードセットを開くと、現在のレコードポインタは、最初のレコードを指していますし、BOFとEOFプロパティはFalseです。 レコードがない場合は、BOFとEOFプロパティをTrueです。
レコードセットオブジェクトは、更新の2種類をサポートできます。
- Immediate updating -あなたはUpdateメソッドを呼び出した後、すべての変更がデータベースにすぐに書き込まれます。
- Batch updating -プロバイダが複数の変更をキャッシュして、UpdateBatchメソッドを使用してデータベースに送信します。
ADOで定義された4つの異なるカーソルタイプがあります。
- Dynamic cursor -あなたが他のユーザーによって追加、変更、および削除を参照してくださいすることができます。
- Keyset cursor -動的カーソルのように、あなたが他のユーザーによって追加を見ることができない、それは他のユーザーが削除したレコードへのアクセスを防止することを除いて。 他のユーザーによるデータの変更は、まだ表示されます。
- Static cursor -あなたがデータを検索したり、レポートを生成するために使用するためのレコードセットの静的コピーを提供します。 他のユーザーによる追加、変更、または削除は表示されません。 これは、クライアント側のRecordsetオブジェクトを開いたときに許可されるカーソルの唯一のタイプです。
- Forward-only cursor -あなただけのレコードセットを順方向にスクロールすることができます。 他のユーザーによる追加、変更、または削除は表示されません。
カーソル・タイプは、カーソル。プロパティによって、またはOpenメソッドにおけるカーソル。パラメータによって設定することができます。
Note:すべてのプロバイダは、Recordsetオブジェクトのすべてのメソッドやプロパティをサポートするわけではありません。
プロパティ
| プロパティ | 説明 |
|---|---|
| AbsolutePage | 設定またはRecordsetオブジェクトにページ番号を指定する値を返します。 |
| AbsolutePosition | セットまたはレコード・オブジェクトの現在のレコードの序数位置を指定する値を返します |
| ActiveCommand | レコードセットに関連付けられているCommandオブジェクトを返します。 |
| ActiveConnection | 設定または接続が開いている場合、接続が閉じられ、または現在の接続オブジェクトされている場合、接続の定義を返します。 |
| BOF | 現在のレコードの位置は、最初のレコードの前にそうでない場合はfalseである場合にtrueを返します |
| Bookmark | 設定やブックマークを返します。 ブックマークは、現在のレコードの位置を保存します |
| CacheSize | 設定またはキャッシュできるレコードの数を返します。 |
| CursorLocation | セットまたはカーソルサービスの場所を返します |
| CursorType | セットまたはレコードセットオブジェクトのカーソルタイプを返します |
| DataMember | セットまたはデータソースプロパティによって参照されるオブジェクトから取得されるデータメンバの名前を返します |
| DataSource | レコードセットオブジェクトとして表現されるデータを含むオブジェクトを指定し |
| EditMode | 現在のレコードの編集状態を返します。 |
| EOF | 現在のレコード位置が最後のレコードの後であればそうでない場合はfalse、trueを返します |
| Filter | セットまたはレコード・オブジェクト内のデータのためのフィルタを返します |
| Index | 設定またはRecordsetオブジェクトの現在のインデックスの名前を返します。 |
| LockType | セットまたはレコードセット内のレコードを編集する場合、ロックの種類を指定する値を返します |
| MarshalOptions | 設定またはレコードがサーバーに返されるかを指定する値を返します。 |
| MaxRecords | 設定またはクエリからレコードセットオブジェクトに戻るにはレコードの最大数を返します。 |
| PageCount | Recordsetオブジェクトのデータとページ数を返します。 |
| PageSize | 設定またはRecordsetオブジェクトの単一ページ上で許容される最大レコード数を返します。 |
| RecordCount | Recordsetオブジェクトのレコード数を返します。 |
| Sort | 設定または上ソートするレコードのフィールド名を返します。 |
| Source | 文字列値またはコマンドオブジェクト参照を設定する、またはレコード・オブジェクトのデータ・ソースを示す文字列値を返します |
| State | データを実行または取得、接続閉じ、レコードセットオブジェクトが開いている場合について説明した値を返します |
| Status | バッチ更新または他の一括操作に関しては、現在のレコードの状態を返します。 |
| StayInSync | 親レコードの位置が変わる子レコードへの参照が変更されるかどうかを設定または返します |
メソッド
| 方法 | 説明 |
|---|---|
| AddNew | 新しいレコードを作成します。 |
| Cancel | 実行をキャンセル |
| CancelBatch | バッチ更新をキャンセル |
| CancelUpdate | Recordsetオブジェクトのレコードに加えられた変更をキャンセルします |
| Clone | 既存のレコードの複製を作成します。 |
| Close | レコードセットを閉じます |
| CompareBookmarks | 2つのブックマークを比較 |
| Delete | レコードまたはレコードのグループを削除します |
| Find | 指定された基準を満たすレコードセット内のレコードを検索します |
| GetRows | 二次元アレイにコピーレコードオブジェクトから複数のレコードを |
| GetString | 文字列としてレコードセットを返します。 |
| Move | Recordsetオブジェクトにレコードポインタを移動します |
| MoveFirst | 最初のレコードにレコードポインタを移動します |
| MoveLast | 最後のレコードにレコードポインタを移動します |
| MoveNext | 次のレコードにレコードポインタを移動します |
| MovePrevious | 前のレコードにレコードポインタを移動します |
| NextRecordset | 現在のレコードのオブジェクトをクリアし、一連のコマンドをループすることによって、次のレコードセットオブジェクトを返します |
| Open | テーブル内のレコードへのあなたのアクセスを提供するデータベース要素、クエリの結果を開き、または保存されたレコードセットに |
| Requery | 元のレコードを作った再実行するクエリによってレコード内のデータを更新します |
| Resync | 元のデータベースから現在のレコードセット内のデータをリフレッシュ |
| Save | ファイルまたはStreamオブジェクトにRecordsetオブジェクトを保存します |
| Seek | 指定された値と一致するレコードを検索するレコードのインデックスを検索します |
| Supports | Recordsetオブジェクトは、特定のタイプの機能をサポートしているかどうかを定義するブール値を返します。 |
| Update | Recordsetオブジェクト内の単一のレコードに行われたすべての変更を保存します。 |
| UpdateBatch | データベースへのレコードセット内のすべての変更を保存します。 バッチ更新モードで作業するときに使用 |
イベント
Note:あなたは（イベントを処理することができる唯一のVisual Basicは、Visual C ++、およびVisual J ++言語）のVBScriptやJScriptを使用してイベントを処理することはできません。
| イベント | 説明 |
|---|---|
| EndOfRecordset | あなたが最後のレコードの後にレコードに移動しようとしたときにトリガ |
| FetchComplete | 非同期操作のすべてのレコードがフェッチされた後にトリガ |
| FetchProgress | 非同期操作で定期的にトリガされ、フェッチされたことをどのように多くの複数のレコードの状態に |
| FieldChangeComplete | Fieldオブジェクト変化の値の後にトリガ |
| MoveComplete | レコードセット内の現在の位置が変更された後にトリガ |
| RecordChangeComplete | レコードが変更された後にトリガ |
| RecordsetChangeComplete | レコードセットが変更された後にトリガ |
| WillChangeField | Fieldオブジェクト変化の値の前にトリガ |
| WillChangeRecord | レコードの変更の前にトリガ |
| WillChangeRecordset | レコードの変更前にトリガ |
| WillMove | レコードの変更の現在の位置の前にトリガ |
コレクション
| コレクション | 説明 |
|---|---|
| Fields | Recordsetオブジェクト内のフィールドオブジェクトの数を示します |
| Properties | Recordsetオブジェクトのすべてのプロパティのオブジェクトが含まれています |
フィールドコレクションのプロパティ
| プロパティ | 説明 |
|---|---|
| Count | フィールドコレクション内の項目の数を返します。 ゼロから始まります。 例： countfields = rs.Fields.Count |
| Item(named_item/number) | フィールドコレクション内の指定されたアイテムを返します。 例： itemfieldsの=のrs.Fields。 Item(1) |
Propertiesコレクションのプロパティ
| プロパティ | 説明 |
|---|---|
| Count | プロパティコレクション内の項目の数を返します。 ゼロから始まります。 例： countprop = rs.Properties.Count |
| Item(named_item/number) | プロパティコレクション内の指定されたアイテムを返します。 例： itemprop = rs.Properties。 Item(1) |