ActiveX Controls Guide (v11)

GetEqual (ActiveX メソッド)

適用対象

VAccess

説明

現在のインデックスと正確に一致するレコードを取得し、Pervasive PSQL ステータス コードを整数値で返します。

構文

object.GetEqual [vLockBias] 

GetEqual メソッドの構文は次のような要素で構成されます。

要素
説明
object
必須。object プレースホルダーは、[適用対象]のオブジェクトを評価するオブジェクト式を表します。
vLockBias
省略可能。レコードを取得する際にセットするレコード ロックの種類を表す値です。デフォルトは 0 で、ロックなしです。次のいずれかの定数を指定できます。
Const BTO_SingleNoWait = 200
Const BTO_MultiNoWait = 400

備考

現在選択されているインデックス フィールドが、オペレーションの実行前にそのフィールドに指定された値と正確に一致する値を含んでいる、ファイル内の最初のレコードを取得します。

このメソッドを呼び出す前に、IndexNumber プロパティによって指定されるインデックスを構成するフィールドの値を設定します。キー フィールドが VA フィールド コントロールにバインドされている場合、その値はバウンド コントロールの内容を修正することによって設定されます。

これらの値をコードから設定するには、FieldValue プロパティを使用します。オペレーションのステータス コードはこのメソッドから返され、コントロールの Status プロパティにも設定されます。ステータスがゼロの場合は正常に実行されたことを示します。

オペレーションの実行が成功するには、キーのすべてのセグメント内のすべてのフィールド、すべてのバイトが同等である必要があります。ステータス コード 4 は、オペレーションの前にキー フィールドに設定された値が現在のインデックス パスで検出されなかったことを示します。オルタネート コレーティング シーケンス(ACS)が指定された文字列キーは、オルタネート コレーティング シーケンスを用いてキー値を解釈するとき、ファイル内にそのキー値とバイト単位で同等のものがある場合にレコードを返します。これは、大文字と小文字を区別しない文字列キーの場合も同じです。

If Check1.Value = 1 Then 
   stat = VAccess1.GetEqual 
Else 
   stat = VAccess1.GetGreaterorEqual 
End If 

GetDirect (ActiveX メソッド)

GetFirst (ActiveX メソッド)