(PWS4 IIS4 IIS5)
PageSize — Recordset の 1 ページを構成するレコード数を示します。
object.PageSize
1 ページのレコード数を示す長整数型 (Long) の値を設定します。また、値の取得も可能です。既定値は 10 です。
データの論理ページを構成するレコード数を調べるには、PageSize プロパティを使います。ページ サイズを設定すると、AbsolutePage プロパティを使用して、特定のページの最初のレコードに移動できます。このプロパティは、Web サーバーで、ユーザーが一度にまとまった数のレコードを参照しながらページ間を移動できるようにする場合などに便利です。
このプロパティはいつでも設定でき、その設定値は特定ページの最初のレコード位置の計算に使われます。
(PWS4 IIS4 IIS5)
PageCount — Recordset オブジェクトに含まれるデータのページ数を示します。
object.PageCount
Recordset のページ数を表す長整数型 (Long) の値を返します。
Recordset オブジェクトに存在するデータのページ数を調べるには、PageCount プロパティを使います。ページとは、PageSize プロパティの設定値と同じサイズで構成されるレコードのグループのことです。最後のページのレコード数が PageSize の値より少なく、そのページが満たされていない場合でも、PageCount 値の対象となる追加されたページとして扱われます。Recordset オブジェクトがこのプロパティをサポートしない場合は値が -1 になり、PageCount を定められないことを意味します。
ページ機能の詳細については、PageSize プロパティおよび AbsolutePage プロパティを参照してください。
(PWS4 IIS4 IIS5)
MaxRecords — クエリから Recordset に返す最大レコード数を示します。
object.MaxRecords
返される最大レコード数を示す長整数型 (Long) の値を設定します。また、値の取得も可能です。既定値は 0 (制限なし) です。
MaxRecords プロパティは、プロバイダがデータ ソースから返すレコード数を制限するために使用します。このプロパティの既定値は 0 で、プロバイダが要求されたすべてのレコードを返すことを意味します。
MaxRecords プロパティは、Recordset が閉じている場合は読み取り/書き込み可能になっていますが、開いている場合は読み取り専用になります。
(PWS4 IIS4 IIS5)
LockType — 編集時にレコードに適用されるロックの種類を示します。
object.LockType
LockTypeEnum の値を設定します。また、値の取得も可能です。既定値は adLockReadOnly です。
プロバイダが Recordset を開くときに使用するロックの種類は、Recordset を開く前に LockType プロパティで指定します。開いている Recordset オブジェクトで使っているロックの種類は、このプロパティを取得すれば確認できます。
プロバイダによってはすべての種類のロックをサポートしていないものもあります。要求した LockType の設定値がサポートされていない場合、ほかの種類のロックに置き換えられます。Recordset オブジェクトで実際に使用可能なロック機能を調べるには、adUpdate と adUpdateBatch を使って Supports メソッドを呼び出します。
CursorLocation プロパティが adUseClient に設定されている場合、adLockPessimistic 設定はサポートされません。サポートされていない値を設定してもエラーにはなりませんが、サポートされる LockType のうち、最も近いロックが使用されます。
LockType プロパティは、Recordset が閉じている場合は読み取り/書き込み可能になっていますが、開いている場合は読み取り専用になります。
RDS での使用 クライアント側の Recordset オブジェクトで使う場合、LockType プロパティは adLockBatchOptimistic にのみ設定できます。
(PWS4 IIS4 IIS5)
Index — Recordset オブジェクトに対して現在有効なインデックス名を示します。
object.Index
(PWS4 IIS4 IIS5)
Filter — Recordset のデータに対するフィルタを示します。
object.Filter
次の中の 1 つを含む、バリアント型 (Variant) の値を設定します。また、値の取得も可能です。
* 検索文字列 – AND または OR 演算子で連結された、1 つまたは複数の句で構成される文字列です。
* ブックマーク配列 – Recordset オブジェクトのレコードを指す固有のブックマーク値の配列です。
* FilterGroupEnum 値です。
Filter プロパティは、Recordset オブジェクトで特定のレコードを抽出するときに使います。フィルタ処理後の Recordset がカレントのカーソルになります。AbsolutePosition、AbsolutePage、RecordCount、PageCount などの、カレント カーソルに基づいて値を返すその他のプロパティが影響を受けます。これは、Filter プロパティに特定の値を設定すると、カレント レコードが新しい値を満たす最初のレコードに移動するからです。
検索文字列は、「フィールド名-演算子-値」形式の句で構成されます (例: “LastName = ‘Smith'”)。AND や OR で句どうしを組み合わせれば、複合句を作成できます (例: “LastName = ‘Smith’ AND FirstName = ‘John'” または “LastName = ‘Smith’ OR LastName = ‘Jones'”)。検索文字列を指定するには、次の点に注意してください。
* 「フィールド名」は、Recordset の有効なフィールド名とします。フィールド名にスペースを含める場合は、名前を角かっこで囲みます。
* 「演算子」には次の中から 1 つを選択して使用します。<、>、<=、>=、<>、=、または LIKE。
* 「値」は、フィールド値と比較される値 (たとえば、’Smith’、#8/24/95#、12.345、または $50.00) のことです。文字列には引用符を、日付にはシャープ記号 (#) を使います。数値では、小数点、ドル記号、および指数表記を使うことができます。「演算子」が LIKE の場合、「値」にワイルドカードを使うことができます。使うことができるワイルドカードはアスタリスク (*) と百分率記号 (%) のみとし、文字列の最後に指定します。「値」に Null を使うことはできません。
注意 単一引用符 (‘) をフィルタ Value に組み込むには、2 つの単一引用符を使って 1 つの単一引用符を表します。たとえば、O’Malley にフィルタを設定するには、検索文字列は、”col1 = ‘O”Malley'” とします。フィルタ値の先頭と末尾に単一引用符を組み込むには、シャープ記号 (#) で文字列を囲みます。たとえば、’1’ にフィルタを設定するには、検索文字列は “col1 = #’1’#” とします。
AND と OR には優先順位はありません。句はかっこでグループにまとめることができます。ただし、次のように、OR で句を結合してできた句のグループを、AND を使ってさらに別の句と結合することはできません。
[sql](LastName = ‘Smith’ OR LastName = ‘Jones’) AND FirstName = ‘John'[/sql]
この場合は、フィルタを次のように構成します。
[sql] (LastName = ‘Smith’ AND FirstName = ‘John’) OR (LastName = ‘Jones’ AND FirstName = ‘John’)[/sql]
LIKE を使った句では、LastName Like ‘*mit*’ のように、パターンの始めと終わりにワイルドカードを指定できます。または、LastName Like ‘Smit*’ のように、パターンの終わりにだけ使うこともできます。
フィルタ定数を使うと、バッチ更新モードでレコード間に競合が発生しても、最後の UpdateBatch メソッドの呼び出しで変更されたレコードだけを表示するなどの方法で、簡単に競合を解消できます。
たとえば、レコードがほかのユーザーによって既に削除されている場合など、基になるデータとの競合が原因で、Filter プロパティの設定に失敗する場合があります。このような場合には、プロバイダは Errors コレクションに警告を返しますが、プログラムの実行は停止されません。要求したすべてのレコードで競合が発生した場合にのみ、実行時エラーが発生します。競合が発生したレコードの位置を調べるには、Status プロパティを使用します。
Filter プロパティに長さ 0 の文字列 (“”) を設定すると、adFilterNone 定数を使った場合と同じ結果が得られます。
Filter プロパティを設定すると、Recordset 内のレコードで、フィルタ処理済みのサブセット内の最初のレコードにカレントレコードの位置が移動します。同様に、Filter プロパティを消去すると、カレント レコードの位置は Recordset の最初のレコードに移動します。
Filter プロパティで使用する配列を作成するときに使用するブックマーク値については、Bookmark プロパティを参照してください。
検索文字列 (OrderDate > ’12/31/1999′ など) 形式の Filter だけが、永続化された Recordset の内容を操作することができます。Bookmark の配列で作成されたフィルタ、または FilterGroupEnum の値を使用して作成されたフィルタは、永続化された Recordset の内容に影響しません。これらの規則は、クライアント側とサーバー側のいずれで作成された Recordset にも当てはまります。
(PWS4 IIS4 IIS5)
eOF — カレント レコードの位置が Recordset オブジェクトの最後のレコードより後にあることを示します。
object.EOF
BOF プロパティは、ブール型 (Boolean) の値を返します。
EOF プロパティは、カレント レコードの位置が最後のレコードより後にある場合は True を返し、カレント レコードの位置が最後のレコード上またはそれ以前にある場合は False を返します。
レコードを持たない Recordset を開くと、BOF プロパティは True に設定されます (Recordset のこの状態については、RecordCount プロパティを参照してください)。少なくとも 1 つのレコードが格納された Recordset オブジェクトを開くと、最初のレコードがカレント レコードになり、BOF プロパティと EOF プロパティは False になります。
Recordset オブジェクトで最後に残ったレコードを削除しても、カレント レコードの位置を移動するまで BOF プロパティは False のままです。
次の表では、BOF プロパティの設定値の組み合わせと、利用できる Move メソッドの種類を示します。
| MoveFirst、MoveLast | MovePrevious、Move < 0 | Move 0 | MoveNext、Move > 0 | |
|---|---|---|---|---|
| BOF=True、EOF=False | 使用可能 | エラー | エラー | 使用可能 |
| BOF=False、EOF=Truee | 使用可能 | 使用可能 | エラー | エラー |
| 両方が True | エラー | エラー | エラー | エラー |
| 両方が False | 使用可能 | 使用可能 | 使用可能 | 使用可能 |
Move メソッドが使えても、そのメソッドによるレコードの位置が見つかったとは限りません。メソッドが使えるとは、指定された Move メソッドを呼び出してもエラーが発生しなかったことを意味するだけです。
次の表は、さまざまな Move メソッドを呼び出してもレコードの位置が見つからない場合に、BOF プロパティに設定される値を示します。
| BOF | EOF | |
|---|---|---|
| MoveFirst、MoveLast | True に設定 | True に設定 |
| Move 0 | 変化なし | 変化なし |
| MovePrevious、Move < 0 | True に設定 | 変化なし |
| MoveNext、Move > 0r | 変化なし | True に設定 |
(PWS4 IIS4 IIS5)
EditMode — カレント レコードの編集ステータスを示します。
object.EditMode = value
EditModeEnum 値を返します。
ADO は、カレントレコードに関連付けられた編集バッファを使います。このプロパティは、このバッファに対して変更が加えられたかどうか、または新規レコードが作成されたかどうかを示します。カレント レコードの編集状態を調べるには、EditMode プロパティを使います。編集プロセスが中断された場合に保留中の変更があるかどうかを確認して、Update または CancelUpdate メソッドを使用する必要があるかどうかを判定できます。
さまざまな編集条件における EditMode プロパティの詳細な説明は、AddNew メソッドを参照してください。
Delete メソッドの呼び出しで、レコードまたはデータ ソースのレコードが正しく削除されなかった場合 (参照整合性違反など)、Recordset は編集モード (EditMode = adEditInProgress) のままになります。これは、カレント レコードから移動する (たとえば Move、NextRecordset、Close などを使用する) 前に、CancelUpdate メソッドを呼び出す必要があることを意味します。
注意 EditMode ではカレント レコードがないと有効な値は返されません。EditMode では、BOF または EOF が TRUE の場合、あるいはカレント レコードが削除された場合にだけエラーが返されます。
(PWS4 IIS4 IIS5)
CursorType — Recordset オブジェクトで使用されるカーソルの種類を示します。
object.CursorType = value
| object | Recordset オブジェクトを指定します。 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| value | カーソルタイプ
以下の値が 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
| object | Recordset オブジェクを指定します。 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| value | カーソルサービス
以下の値が value パラメータ文字列として認識されます
|
CursorLocationEnum 値のいずれか 1 つに設定可能な長整数型 (Long) の値を設定します。また、値の取得も可能です。
このプロパティで、プロバイダにアクセス可能なさまざまなカーソル ライブラリの中からカーソル サービスを選択します。通常は、クライアント側カーソル ライブラリ、またはサーバー側カーソル ライブラリから選択します。
このプロパティ設定は、プロパティが設定された後に確立された接続のみに作用します。CursorLocation プロパティを変更しても既存の接続には影響しません。
Execute メソッドが返すカーソルは、この設定を継承します。Recordset オブジェクトは関連付けられた接続からこの設定を自動的に継承します。
このプロパティは、Connection または閉じている Recordset 上では読み取り/書き込み可能で、開いている Recordset 上では読み取り専用です。
RDS での使用 クライアント側の Recordset オブジェクトまたは Connection オブジェクトで使う場合、CursorLocation プロパティは adUseClient にのみ設定できます。