SqlSyncAdapterBuilder 類別
建立 SyncAdapter 以及讓用戶端與 SQL Server 資料庫同步所需的 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 陳述式。同步處理配接器產生器讓您能夠指定下列資訊：
您要同步 (Synchronize) 的資料表
這些資料表中的追蹤資料行
同步處理的方向
要包含哪些資料列和資料行
同步處理配接器產生器會使用此資訊，建立同步處理配接器及 Transact-SQL 命令。 同步處理配接器產生器與 SQL Server 2000 及較新版相容。
注意
透過使用同步處理配接器產生器，您可以對同步處理命令更加熟悉。不過，如果可以的話，我們建議您手動指定使用預存程序 (Stored Procedure) 的命令。預存程序能夠協助改進應用程式的效能和安全性。
範例
下列程式碼範例會藉由使用 SqlSyncAdapterBuilder，針對 Customer 資料表建立 SyncAdapter 物件。此資料表中的資料行會針對幾個屬性來指定，而且同步處理會指定為雙向。若要在完整範例的內容中檢視這段程式碼，請參閱 HOW TO：使用事件和程式商務邏輯。
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) 成員都是安全執行緒。不保證任何執行個體成員都可以是安全執行緒。