SqlSyncAdapterBuilder クラス

クライアントを SQL Server データベースと同期する際に必要な SyncAdapter および SQL コマンドを作成します。

名前空間: Microsoft.Synchronization.Data.Server
アセンブリ: Microsoft.Synchronization.Data.Server (microsoft.synchronization.data.server.dll 内)

構文

'宣言
Public Class SqlSyncAdapterBuilder
    Inherits Component
'使用
Dim instance As SqlSyncAdapterBuilder

public class SqlSyncAdapterBuilder : Component

public ref class SqlSyncAdapterBuilder : public Component

public class SqlSyncAdapterBuilder extends Component

public class SqlSyncAdapterBuilder extends Component

解説

同期アダプター ビルダーは、ADO.NET のコマンド ビルダーをモデルとしています。このツールを使用すると、サーバー同期プロバイダーによって実行される同期コマンドのコードを開発できます。同期アダプター ビルダーでは、同期にかかわるテーブルに関して指定された情報を基に、SQL Server データベースに対する SELECT、INSERT、UPDATE、および DELETE の各ステートメントが作成されます。同期アダプター ビルダーを使用すると、次の情報を指定できます。

• 同期するテーブル

• 同期するテーブル内の追跡中の列

• 同期の方向

• 含める行と列

同期アダプター ビルダーでは、この情報を使用して、同期アダプターと Transact-SQL コマンドを作成します。同期アダプター ビルダーは、SQL Server 2000 以降のバージョンと互換性があります。

注意

同期アダプター ビルダーを使用すると、同期コマンドについて詳細に理解することができます。ただし、可能であれば、ストアド プロシージャを使用するコマンドを手動で指定することをお勧めします。ストアド プロシージャは、アプリケーションのパフォーマンスとセキュリティの向上に役立ちます。

例

次のコード例では、SqlSyncAdapterBuilder を使用して Customer テーブルの SyncAdapter オブジェクトを作成します。いくつかのプロパティにテーブルの列が指定され、双方向として同期が指定されます。完全なコンテキスト例でこのコードを表示するには、「イベントを操作する方法とビジネス ロジックをプログラムする方法」を参照してください。

SqlSyncAdapterBuilder customerBuilder = new SqlSyncAdapterBuilder(serverConn);

customerBuilder.TableName = "Sales.Customer";
customerBuilder.TombstoneTableName = customerBuilder.TableName + "_Tombstone";
customerBuilder.SyncDirection = SyncDirection.Bidirectional;
customerBuilder.CreationTrackingColumn = "InsertTimestamp";
customerBuilder.UpdateTrackingColumn = "UpdateTimestamp";
customerBuilder.DeletionTrackingColumn = "DeleteTimestamp";
customerBuilder.CreationOriginatorIdColumn = "InsertId";
customerBuilder.UpdateOriginatorIdColumn = "UpdateId";
customerBuilder.DeletionOriginatorIdColumn = "DeleteId";

SyncAdapter customerSyncAdapter = customerBuilder.ToSyncAdapter();
customerSyncAdapter.TableName = "Customer";
this.SyncAdapters.Add(customerSyncAdapter);

Dim customerBuilder As New SqlSyncAdapterBuilder(serverConn)
With customerBuilder
    .TableName = "Sales.Customer"
    .TombstoneTableName = customerBuilder.TableName + "_Tombstone"
    .SyncDirection = SyncDirection.Bidirectional
    .CreationTrackingColumn = "InsertTimestamp"
    .UpdateTrackingColumn = "UpdateTimestamp"
    .DeletionTrackingColumn = "DeleteTimestamp"
    .CreationOriginatorIdColumn = "InsertId"
    .UpdateOriginatorIdColumn = "UpdateId"
    .DeletionOriginatorIdColumn = "DeleteId"
End With

Dim customerSyncAdapter As SyncAdapter = customerBuilder.ToSyncAdapter()
customerSyncAdapter.TableName = "Customer"
Me.SyncAdapters.Add(customerSyncAdapter)

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      Microsoft.Synchronization.Data.Server.SqlSyncAdapterBuilder

スレッド セーフ

この型の public static (Visual Basic では Shared ) メンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

参照

リファレンス

SqlSyncAdapterBuilder メンバー
Microsoft.Synchronization.Data.Server 名前空間