Partager via

Classe SqlSyncAdapterBuilder

  • Article

Crée un objet SyncAdapter et les commandes SQL requises pour synchroniser un client avec une base de données SQL Server.

Espace de noms: Microsoft.Synchronization.Data.Server
Assembly: Microsoft.Synchronization.Data.Server (dans microsoft.synchronization.data.server.dll)

Syntaxe

'Déclaration
Public Class SqlSyncAdapterBuilder
    Inherits Component
'Utilisation
Dim instance As SqlSyncAdapterBuilder

public class SqlSyncAdapterBuilder : Component

public ref class SqlSyncAdapterBuilder : public Component

public class SqlSyncAdapterBuilder extends Component

public class SqlSyncAdapterBuilder extends Component

Notes

Le générateur de l'adaptateur de synchronisation repose sur le générateur de commande dans ADO.NET. Vous pouvez utiliser cet outil pour développer du code pour les commandes de synchronisation qui sont exécutées par le fournisseur de synchronisation serveur. Le générateur de l'adaptateur de synchronisation produit des instructions SELECT, INSERT, UPDATE et DELETE pour les bases de données SQL Server en fonction des informations que vous fournissez sur les tables participant à la synchronisation. Le générateur de l'adaptateur de synchronisation vous permet de spécifier les informations suivantes :

  • Tables devant faire l'objet d'une synchronisation

  • Colonnes de suivi de ces tables

  • Direction de la synchronisation

  • Lignes et colonnes à inclure

Le générateur de l'adaptateur de synchronisation utilise ces informations pour créer un adaptateur de synchronisation et des commandes Transact-SQL. Le générateur de l'adaptateur de synchronisation est compatible avec SQL Server 2000 et versions ultérieures.

Notes

Vous pouvez utiliser le générateur de l'adaptateur de synchronisation pour vous familiariser avec les commandes de synchronisation. Cependant, nous vous recommandons de spécifier manuellement les commandes qui utilisent des procédures stockées, si vous le pouvez. Les procédures stockées peuvent contribuer à renforcer les performances et la sécurité de l'application.

Exemple

L'exemple de code suivant crée un objetSyncAdapter pour la table Customer à l'aide de SqlSyncAdapterBuilder. Les colonnes de la table sont spécifiées pour plusieurs propriétés et la synchronisation est désignée comme étant bidirectionnelle. Pour afficher ce code dans le contexte d'un exemple complet, consultez Procédure : travailler avec des événements et programmer la logique métier.

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)

Hiérarchie d'héritage

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

Sécurité des threads

Tous les membres publics statiques (Partagés en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Membres SqlSyncAdapterBuilder
Espace de noms Microsoft.Synchronization.Data.Server