方法 : ローカルデータベースとリモートデータベースの間で同期を開始する

2011-08-09

ローカルデータベースキャッシュを追加し、[データ同期の構成] ダイアログボックスで構成情報を入力した場合でも、ローカルデータベースとリモートデータベースを実際に同期するコードをアプリケーションに追加する必要があります。同期は、SyncAgent の Synchronize メソッドを呼び出すことにより開始します。

この処理で同期されるのは、リモートデータベースとローカルデータベース (.sdf) の間のデータだけである点を理解することが重要です。アプリケーション内のデータは、引き続きデータベースから再読み込みする必要があります。必ず、アプリケーションデータソースに、ローカルデータベースから更新されたデータを再読み込みしてください。たとえば、TableAdapter.Fill メソッドを呼び出して、データセットのデータテーブルにローカルデータベースから更新されたデータを読み込みます。

[データ同期の構成] ダイアログボックスには [コードスニペットの表示] リンクがあり、Synchronize メソッドを呼び出す正しい構文が含まれるコードスニペットを使用できます。アプリケーション内の同期を実行する必要がある場所に、このコードスニペットを追加します。

注意

お使いのマシンで、Visual Studio ユーザーインターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。

手順

ローカルデータベースとリモートデータベースの間で同期を開始するには

ソリューションエクスプローラーで .sync ファイルをダブルクリックし、[データ同期の構成] ダイアログボックスを開きます。
[データ同期の構成] ダイアログボックスの [コードスニペットの表示] リンクをクリックします。
[コードをクリップボードにコピー] をクリックし、[閉じる] をクリックします。

前の手順でコピーしたコードスニペットをアプリケーションに貼り付けます。同期呼び出しを開始する場所に貼り付けます。次のコードに、Northwind の "顧客" テーブルを同期するように構成されたアプリケーションで同期を開始する方法を示します。

' Call the Synchronize method to synchronize
' data between local and remote databases.
Dim syncAgent As NorthwindCacheSyncAgent = New NorthwindCacheSyncAgent()
Dim syncStats As Microsoft.Synchronization.Data.SyncStatistics =
    syncAgent.Synchronize()

' After synchronizing the data, refill the
' table in the dataset.
Me.CustomersTableAdapter.Fill(NorthwindDataSet.Customers)

// Call the Synchronize method to synchronize
// data between local and remote databases.
NorthwindCacheSyncAgent syncAgent = new NorthwindCacheSyncAgent();
Microsoft.Synchronization.Data.SyncStatistics syncStats;
syncStats = syncAgent.Synchronize();
// After synchronizing the data, refill the
// table in the dataset.
this.customersTableAdapter.Fill(this.northwindDataSet.Customers);