Compartilhar via


Classe SqlSyncAdapterBuilder

Cria um SyncAdapter e os comandos SQL necessários para sincronizar um cliente com um banco de dados do SQL Server.

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

Sintaxe

'Declaração
Public Class SqlSyncAdapterBuilder
    Inherits Component
'Uso
Dim instance As SqlSyncAdapterBuilder
public class SqlSyncAdapterBuilder : Component
public ref class SqlSyncAdapterBuilder : public Component
public class SqlSyncAdapterBuilder extends Component
public class SqlSyncAdapterBuilder extends Component

Comentários

O construtor de adaptadores de sincronização é modelado após o construtor de comandos no ADO.NET. Você pode usar essa ferramenta para desenvolver código para comandos de sincronização executados pelo provedor de sincronização do servidor. O construtor de adaptadores de sincronização produz as instruções SELECT, INSERT, UPDATE e DELETE para bancos de dados do SQL Server com base nas informações que você fornece sobre as tabelas envolvidas na sincronização. O construtor de adaptadores de sincronização permite que você especifique as seguintes informações:

  • As tabelas que você deseja sincronizar

  • As colunas de controle dessas tabelas

  • A direção da sincronização

  • Quais linhas e colunas devem ser incluídas

O construtor de adaptadores de sincronização usa essas informações para criar um adaptador de sincronização e comandos Transact-SQL. Ele é compatível com o SQL Server 2000 e versões posteriores.

Dica

É possível usar o construtor de adaptadores de sincronização para se familiarizar com os comandos de sincronização. No entanto, se possível, é recomendável que você especifique manualmente os comandos que usam procedimentos armazenados. Os procedimentos armazenados podem ajudar a melhorar o desempenho e a segurança do aplicativo.

Exemplo

O exemplo de código a seguir cria um objeto SyncAdapter para a tabela Customer usando o SqlSyncAdapterBuilder. São especificadas colunas da tabela para várias propriedades, e a sincronização é especificada como bidirecional. Para exibir esse código no contexto de um exemplo completo, consulte Como trabalhar com eventos e com a lógica de negócios do programa.

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)

Hierarquia de herança

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

Segurança de thread

Qualquer membro estático público (Compartilhado no Visual Basic) deste tipo é protegido por thread. Não há garantia de que qualquer membro de instância esteja protegido por thread.

Consulte também

Referência

Membros SqlSyncAdapterBuilder
Namespace Microsoft.Synchronization.Data.Server