Classe SqlSyncAdapterBuilder

Articolo
10/17/2009

Crea un oggetto SyncAdapter e i comandi SQL necessari per la sincronizzazione di un client con un database SQL Server.

Spazio dei nomi: Microsoft.Synchronization.Data.Server
Assembly: Microsoft.Synchronization.Data.Server (in microsoft.synchronization.data.server.dll)

Sintassi

'Dichiarazione
Public Class SqlSyncAdapterBuilder
    Inherits Component
'Utilizzo
Dim instance As SqlSyncAdapterBuilder

public class SqlSyncAdapterBuilder : Component

public ref class SqlSyncAdapterBuilder : public Component

public class SqlSyncAdapterBuilder extends Component

public class SqlSyncAdapterBuilder extends Component

Osservazioni

Il compilatore dell'adattatore di sincronizzazione è modellato in base al compilatore comandi in ADO.NET. È possibile utilizzare questo strumento per sviluppare codice per i comandi di sincronizzazione eseguiti dal provider di sincronizzazione server. Il compilatore dell'adattatore di sincronizzazione produce istruzioni SELECT, INSERT, UPDATE e DELETE per i database SQL Server in base alle informazioni fornite sulle tabelle coinvolte nella sincronizzazione. Il compilatore dell'adattatore di sincronizzazione consente di specificare le informazioni seguenti:

Le tabelle che si desidera sincronizzare
Le colonne di rilevamento in tali tabelle
La direzione di sincronizzazione
Le righe e le colonne da includere

Il compilatore dell'adattatore di sincronizzazione utilizza tali informazioni per creare un adattatore di sincronizzazione e i comandi Transact-SQL. Il compilatore dell'adattatore di sincronizzazione è compatibile con SQL Server 2000 e versioni successive.

Nota

È possibile utilizzare il compilatore dell'adattatore di sincronizzazione per acquisire familiarità con i comandi di sincronizzazione. Tuttavia, se possibile, si consiglia di specificare manualmente i comandi che utilizzano stored procedure. Le stored procedure consentono di migliorare le prestazioni e la sicurezza dell'applicazione.

Esempio

Nell'esempio di codice seguente viene creato un oggetto SyncAdapter per la tabella Customer tramite SqlSyncAdapterBuilder. Le colonne della tabella vengono specificate per diverse proprietà e la sincronizzazione viene specificata come bidirezionale. Per visualizzare questo codice nel contesto di un esempio completo, vedere Procedura: utilizzare gli eventi e la logica di business del programma.

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)

Gerarchia di ereditarietà

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

Thread Safety

Tutti i membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread safe. I membri di istanza non hanno garanzia di essere thread safe.

Vedere anche

Riferimento

Membri SqlSyncAdapterBuilder
Spazio dei nomi Microsoft.Synchronization.Data.Server

Condividi tramite