Proprietà SyncConfiguration.SyncParameters

Ottiene una raccolta SyncParameterCollection di oggetti SyncParameter disponibili nel server come variabili di sessione.

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

Sintassi

'Dichiarazione
Public ReadOnly Property SyncParameters As SyncParameterCollection
'Utilizzo
Dim instance As SyncConfiguration
Dim value As SyncParameterCollection

value = instance.SyncParameters

public SyncParameterCollection SyncParameters { get; }

public:
property SyncParameterCollection^ SyncParameters {
    SyncParameterCollection^ get ();
}

/** @property */
public SyncParameterCollection get_SyncParameters ()

public function get SyncParameters () : SyncParameterCollection

Valore proprietà

Raccolta SyncParameterCollection di oggetti SyncParameter.

Osservazioni

I parametri di sincronizzazione vengono in genere utilizzati per passare informazioni sui filtri all'agente di sincronizzazione e vengono quindi utilizzati in comandi per l'adattatore di sincronizzazione.

Esempio

Nell'esempio di codice seguente viene illustrata una classe che deriva da SyncAgent. Il codice consente di creare un oggetto SyncParameter che specifica un valore per il parametro @SalesPerson. In un'applicazione tale valore può derivare un ID di accesso o da altro input utente. Per visualizzare il codice nel contesto di un esempio completo, vedere Procedura: filtrare righe e colonne.

this.Configuration.SyncParameters.Add(
    new SyncParameter("@SalesPerson", "Brenda Diaz"));

Me.Configuration.SyncParameters.Add(New SyncParameter("@SalesPerson", "Brenda Diaz"))

Nell'esempio di codice seguente viene illustrata una classe che deriva da DbServerSyncProvider. Nel codice vengono specificate le colonne e righe inserite da scaricare per la tabella Customer. È possibile impostare come hardcoded un valore per SalesPerson. Tuttavia, in genere viene utilizzato un parametro con un valore modificabile, come mostrato nell'esempio. Nell'esempio il parametro del filtro viene passato insieme agli altri parametri richiesti per scaricare gli inserimenti incrementali.

SqlCommand customerIncrInserts = new SqlCommand();
customerIncrInserts.CommandText =
    "SELECT CustomerId, CustomerName, CustomerType " +
    "FROM Sales.Customer " +
    "WHERE SalesPerson = @SalesPerson " +
    "AND (InsertTimestamp > @sync_last_received_anchor " +
    "AND InsertTimestamp <= @sync_new_received_anchor " +
    "AND InsertId <> @sync_client_id)";
customerIncrInserts.Parameters.Add("@SalesPerson", SqlDbType.NVarChar);
customerIncrInserts.Parameters.Add("@" + SyncSession.SyncLastReceivedAnchor, SqlDbType.Timestamp);
customerIncrInserts.Parameters.Add("@" + SyncSession.SyncNewReceivedAnchor, SqlDbType.Timestamp);
customerIncrInserts.Parameters.Add("@" + SyncSession.SyncClientId, SqlDbType.UniqueIdentifier);
customerIncrInserts.Connection = serverConn;
customerSyncAdapter.SelectIncrementalInsertsCommand = customerIncrInserts;

Dim customerIncrInserts As New SqlCommand()
With customerIncrInserts
    .CommandText = _
        "SELECT CustomerId, CustomerName, CustomerType " _
      & "FROM Sales.Customer " _
      & "WHERE SalesPerson = @SalesPerson " _
      & "AND (InsertTimestamp > @sync_last_received_anchor " _
      & "AND InsertTimestamp <= @sync_new_received_anchor " _
      & "AND InsertId <> @sync_client_id)"
    .Parameters.Add("@SalesPerson", SqlDbType.NVarChar)
    .Parameters.Add("@" + SyncSession.SyncLastReceivedAnchor, SqlDbType.Timestamp)
    .Parameters.Add("@" + SyncSession.SyncNewReceivedAnchor, SqlDbType.Timestamp)
    .Parameters.Add("@" + SyncSession.SyncClientId, SqlDbType.UniqueIdentifier)
    .Connection = serverConn
End With
customerSyncAdapter.SelectIncrementalInsertsCommand = customerIncrInserts

Vedere anche

Riferimento

Classe SyncConfiguration
Membri SyncConfiguration
Spazio dei nomi Microsoft.Synchronization.Data