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

线程安全

此类型的所有公共静态（在 Visual Basic 中共享 ）成员都是线程安全的。不保证任何实例成员的线程安全。

请参阅

参考

SqlSyncAdapterBuilder 成员
Microsoft.Synchronization.Data.Server 命名空间