基になるデータベースから、現在の Recordset オブジェクト、または Record オブジェクトのコレクション Fields 内のデータを更新します。
構文
Recordset.Resync AffectRecords, ResyncValues Record.Fields.Resync ResyncValues
パラメーター
AffectRecords
随意。
Resync メソッドが影響を受けるレコードの数を決定する AffectEnum 値。 既定値は adAffectAll です。 この値は、Record オブジェクトの Fields コレクションの Resync メソッドでは使用できません。
ResyncValues
随意。 基になる値を上書きするかどうかを示す ResyncEnum 値です。 既定値は adResyncAllValues です。
備考
Recordset
Resync メソッドを使用して、現在の Recordset 内のレコードを基になるデータベースと再同期します。 これは、静的カーソルまたは前方専用カーソルを使用しているが、基になるデータベースの変更を確認する場合に便利です。
CursorLocation プロパティを adUseClient 設定した場合、再同期 は、読み取り専用でない Recordset オブジェクトでのみ使用できます。
Requery メソッドとは異なり、Resync メソッドは、Recordset オブジェクトの基になるコマンドを再実行しません。 基になるデータベース内の新しいレコードは表示されません。
基になるデータとの競合が原因で再同期が失敗した場合 (たとえば、レコードが別のユーザーによって削除された場合)、プロバイダーは Errors コレクションに警告を返し、実行時エラーが発生します。 Filter プロパティ (adFilterConflictingRecords) と Status プロパティを使用して、競合するレコードを検索します。
一意テーブル と Resync コマンド 動的プロパティが設定され、Recordset が複数のテーブルに対して JOIN 操作を実行した結果である場合、Resync メソッドは、Resync Command プロパティで指定されたコマンドを、Unique Table プロパティに指定されたテーブルでのみ実行します。
田畑
Record オブジェクトの Fields コレクションの値を基になるデータ ソースと再同期するには、Resync メソッドを使用します。 Count プロパティは、このメソッドの影響を受けません。
ResyncValues が adResyncAllValues (既定値) に設定されている場合、コレクション内の Field オブジェクトの UnderlyingValue、Value、および OriginalValue プロパティが同期されます。 ResyncValues が adResyncUnderlyingValues に設定されている場合、UnderlyingValue プロパティのみが同期されます。
呼び出し時の各 Field オブジェクトの Status プロパティの値は、Resyncの動作にも影響します。 adFieldPendingUnknown または adFieldPendingInsert Status 値を持つ Field オブジェクトの場合、再同期 は無効です。 adFieldPendingChange または adFieldPendingDelete の 状態 値の場合、Resync は、データ ソースにまだ存在するフィールドのデータ値を同期します。
Resync は、Resync が呼び出されたときにエラーが発生しない限り、Field オブジェクトの Status 値 変更しません。 たとえば、フィールドが存在しなくなった場合、プロバイダーは、adFieldDoesNotExist など、Field オブジェクトの適切な 状態 値返します。 返される Status 値は、Status プロパティの値内で論理的に組み合わせることができます。
適用対象
関連項目
Resync メソッドの使用例 (VB)
Resync メソッドの使用例 (VC++)
Clear メソッド (ADO)
UnderlyingValue プロパティの