SqlSyncAdapterBuilder-Klasse

Artikel
11/02/2009

Erstellt einen SyncAdapter und die SQL-Befehle, die zum Synchronisieren eines Clients mit einer SQL Server-Datenbank benötigt werden.

Namespace: Microsoft.Synchronization.Data.Server
Assembly: Microsoft.Synchronization.Data.Server (in microsoft.synchronization.data.server.dll)

Syntax

'Declaration
Public Class SqlSyncAdapterBuilder
    Inherits Component
'Usage
Dim instance As SqlSyncAdapterBuilder

public class SqlSyncAdapterBuilder : Component

public ref class SqlSyncAdapterBuilder : public Component

public class SqlSyncAdapterBuilder extends Component

public class SqlSyncAdapterBuilder extends Component

Hinweise

Der Synchronisierungsadapter-Generator wurde nach dem Vorbild des Befehlsgenerators von ADO.NET entwickelt. Mit diesem Tool können Sie Code für die Synchronisierungsbefehle entwickeln, die vom Serversynchronisierungsanbieter ausgeführt werden. Der Synchronisierungsadapter-Generator produziert auf der Grundlade der Informationen, die Sie zu den an der Synchronisierung beteiligten Tabellen bereitstellen, SELECT-, INSERT-, UPDATE- und DELETE-Anweisungen für SQL Server-Datenbanken. Mithilfe dieses Generators können die folgenden Informationen angegeben werden:

die Tabellen, die synchronisiert werden sollen
die Nachverfolgungsspalten in diesen Tabellen
die Synchronisierungsrichtung
die einzuschließenden Zeilen und Spalten

Der Synchronisierungsadapter-Generator verwendet diese Informationen zum Erstellen eines Synchronisierungsadapters und zum Erstellen von Transact-SQL-Befehlen. Der Synchronisierungsadapter-Generator ist mit SQL Server 2000 und höheren Versionen kompatibel.

Hinweis

Sie können den Synchronisierungsadapter-Generator auch verwenden, um sich mit den Synchronisierungsbefehlen vertraut zu machen. Wir empfehlen aber, Befehle, die gespeicherte Prozeduren verwenden, möglichst manuell anzugeben. Die Verwendung von gespeicherten Prozeduren trägt zu einer besseren Arbeitsgeschwindigkeit und einer größeren Sicherheit der Anwendung bei.

Beispiel

Das folgende Codebeispiel erstellt mithilfe des SqlSyncAdapterBuilder ein SyncAdapter-Objekt für die Customer-Tabelle. In der Tabelle werden Spalten für die verschiedenen Eigenschaften eingerichtet, und als Synchronisierungstyp wird die bidirektionale Synchronisierung festgelegt. Eine Darstellung dieses Codes im Kontext eines vollständigen Beispiels finden Sie unter Vorgehensweise: Arbeiten mit Ereignissen und Programmgeschäftslogik.

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)

Vererbungshierarchie

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

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

SqlSyncAdapterBuilder-Member
Microsoft.Synchronization.Data.Server-Namespace

Freigeben über