データ元のデータベースからのデータを使用して、現在の Recordset オブジェクトのデータを更新します。
recordset.Resync AffectRecords
Resync メソッドの構文には、次の指定項目があります。
|
指定項目 |
説明 |
|
recordset |
開いている Recordset オブジェクトを表すオブジェクト変数です。 |
|
AffectRecords |
(省略可能) AffectEnum 値です。 (省略可能) Resync メソッドの作用を受けるレコード数を決める AffectEnum 値です。次の定数のうちの 1 つを指定できます。 |
|
adAffectCurrent、1 ｾ カレント レコードだけを更新します。 adAffectGroup、2 ｾ 現在の Filter プロパティの設定を満たすレコードを更新します。このオプションを使用するには、有効な定義済み定数のうちの 1 つを Filter プロパティに設定する必要があります。 adAffectAll、3 (デフォルト) ｾ 現在の Filter プロパティの設定により隠されているものも含む、Recordset オブジェクト内のすべてのレコードを更新します。 |
Resync メソッドは、現在の Recordset のレコードとデータ元のデータベースとの間で、データの再同期を行います。このメソッドは、静的カーソルや前方スクロール カーソルを使用していて、データ元のデータベースで変更があったかどうかを確認したい場合に便利です。Resync メソッドを呼び出すと、未処理のバッチ更新がすべてキャンセルされます。
Resync メソッドは Refresh メソッドとは異なり、Recordset オブジェクトの生成元のコマンドを再実行しません。このため、データ元のデータベースの新しいレコードは参照できません。
元になっているデータと競合するために再同期ができない場合 (たとえば別のユーザーが既にレコードを削除している場合など)、プロバイダは Errors コレクションに警告を返しますが、プログラムの実行を中断することはありません。ランタイム エラーは、要求されたレコードすべてが競合を起こした場合にだけ起こります。競合を起こしたレコードを探すには、Filter プロパティ (adFilterAffectedRecords) および Status プロパティを使います。