Classe SqlSyncAdapterBuilder
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
type SqlSyncAdapterBuilder =
class
inherit Component
end
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.
Exemples
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 static (Shared dans Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.