Costruttore SyncParameter (String, Object)

Inizializza una nuova istanza della classe SyncParameter utilizzando i parametri di nome e valore.

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

Sintassi

'Dichiarazione
Public Sub New ( _
    name As String, _
    value As Object _
)
'Utilizzo
Dim name As String
Dim value As Object

Dim instance As New SyncParameter(name, value)

public SyncParameter (
    string name,
    Object value
)

public:
SyncParameter (
    String^ name, 
    Object^ value
)

public SyncParameter (
    String name, 
    Object value
)

public function SyncParameter (
    name : String, 
    value : Object
)

Parametri

• name
  Nome del parametro.

• value
  Valore del parametro.

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 SyncParameter
Membri SyncParameter
Spazio dei nomi Microsoft.Synchronization.Data