BOF、EOF プロパティ (ADO)BOF, EOF Properties (ADO)

  • BOFの最初のレコードの前に、現在のレコードの位置があることを示します、 Recordsetオブジェクト。BOF Indicates that the current record position is before the first record in a Recordset object.

  • EOFの最後のレコードの後、現在のレコードの位置にあることを示します、 Recordsetオブジェクト。EOF Indicates that the current record position is after the last record in a Recordset object.

戻り値Return Value

BOFEOFプロパティの戻り値ブール値。The BOF and EOF properties return Boolean values.

コメントRemarks

使用、 BOFEOFプロパティを確認するかどうかをレコード セットレコードまたはかどうかが確認済みの制限を超えるオブジェクトが含まれています、レコード セットレコード間を移動するときのオブジェクトします。Use the BOF and EOF properties to determine whether a Recordset object contains records or whether you have gone beyond the limits of a Recordset object when you move from record to record.

BOFプロパティが返すTrue (-1) 場合、現在のレコードの位置を先頭レコードの前に、とFalseレコードの現在の位置は 1 つ目以降の場合は (0)レコードです。The BOF property returns True (-1) if the current record position is before the first record and False (0) if the current record position is on or after the first record.

EOFプロパティが返すTrueレコードの現在の位置が最後のレコード後がある場合とFalseレコードの現在の位置がまたは最後のレコードの前にある場合。The EOF property returns True if the current record position is after the last record and False if the current record position is on or before the last record.

どちらの場合、 BOFまたはEOFプロパティはTrue、現在のレコードはありません。If either the BOF or EOF property is True, there is no current record.

開く場合、レコード セットオブジェクト、レコードが含まれていない、 BOFEOFプロパティに設定されますTrue (を参照してください、 RecordCountプロパティのこの状態の詳細については、 Recordset)。If you open a Recordset object containing no records, the BOF and EOF properties are set to True (see the RecordCount property for more information about this state of a Recordset). 開くと、レコード セットに少なくとも 1 つのレコード、最初のレコードを格納しているオブジェクトが現在のレコードとBOFEOFプロパティは、 False.When you open a Recordset object that contains at least one record, the first record is the current record and the BOF and EOF properties are False.

最後の残りのレコードを削除する場合、レコード セットオブジェクト、 BOFEOFプロパティが残る可能性があるFalseまで現在のレコードの位置を変更しようとしてください。If you delete the last remaining record in the Recordset object, the BOF and EOF properties may remain False until you attempt to reposition the current record.

次の表では移動のさまざまな組み合わせで使用できるメソッド、 BOFEOFプロパティ。This table shows which Move methods are allowed with different combinations of the BOF and EOF properties.

MoveFirst、MoveFirst,

MoveLastMoveLast
MovePrevious、MovePrevious,

< 0 を移動します。Move < 0
0 を移動します。Move 0 MoveNext、MoveNext,

> 0 を移動します。Move > 0
BOF=TrueEOF=FalseBOF=True, EOF=False AllowedAllowed ErrorError ErrorError AllowedAllowed
BOF=FalseEOF=は True。BOF=False, EOF=True AllowedAllowed AllowedAllowed ErrorError ErrorError
両方は True。Both True ErrorError ErrorError ErrorError ErrorError
どちらもFalseBoth False AllowedAllowed AllowedAllowed AllowedAllowed AllowedAllowed

許可、移動メソッドでは、メソッドが正常にレコードを見つけるは保証されません。 その呼び出し、指定したに過ぎません移動メソッドでは、エラーは生成されません。Allowing a Move method does not guarantee that the method will successfully locate a record; it only means that calling the specified Move method will not generate an error.

次の表は、事象、 BOFEOFさまざまな呼び出すときに、プロパティの設定移動メソッド、ことはできませんが正常にレコードを検索します。The following table shows what happens to the BOF and EOF property settings when you call various Move methods but are unable to successfully locate a record.

BOFBOF EOFEOF
MoveFirstMoveLastMoveFirst, MoveLast 設定は True。Set to True 設定は True。Set to True
移動0Move 0 変更なしNo change 変更なしNo change
MovePrevious移動< 0MovePrevious, Move < 0 設定は True。Set to True 変更なしNo change
MoveNext移動> 0MoveNext, Move > 0 変更なしNo change 設定は True。Set to True

適用対象Applies To

Recordset オブジェクト (ADO)Recordset Object (ADO)

関連項目See Also

BOF、EOF、および Bookmark プロパティの例 (VB) BOF, EOF, and Bookmark Properties Example (VB)
BOF、EOF、および Bookmark プロパティの例 (vc++)BOF, EOF, and Bookmark Properties Example (VC++)