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
type SqlSyncAdapterBuilder =  
    class
        inherit Component
    end
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

线程安全

此类型的所有公共成员static(在 Visual Basic 中为 Shared) 都是线程安全的。不保证所有实例成员都是线程安全的。

请参阅

参考

SqlSyncAdapterBuilder 成员

Microsoft.Synchronization.Data.Server 命名空间