SyncParameter Clase

Encapsula la información enviada al servidor desde el cliente.

Espacio de nombres: Microsoft.Synchronization.Data
Ensamblado: Microsoft.Synchronization.Data (en microsoft.synchronization.data.dll)

Sintaxis

'Declaración
<SerializableAttribute> _
Public Class SyncParameter
'Uso
Dim instance As SyncParameter
[SerializableAttribute] 
public class SyncParameter
[SerializableAttribute] 
public ref class SyncParameter
/** @attribute SerializableAttribute() */ 
public class SyncParameter
SerializableAttribute 
public class SyncParameter

Notas

Los parámetros de sincronización se utilizan generalmente para pasar información de filtrado al agente de sincronización. Estos parámetros se utilizan, a continuación, en comandos para el adaptador de sincronización.

Ejemplo

El ejemplo de código siguiente procede de una clase derivada de SyncAgent. Este código crea un objeto SyncParameter que especifica un valor para el parámetro @SalesPerson. En una aplicación, este valor podría obtenerse de un Id. de inicio de sesión u otra información especificada por el usuario. Para consultar código en el contexto de un ejemplo completo, vea Filtrar filas y columnas.

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

El ejemplo de código siguiente procede de una clase derivada de DbServerSyncProvider. En este código se especifica qué columnas y filas insertadas se descargan para la tabla Customer. Puede codificar un valor para SalesPerson. No obstante, es más frecuente usar un parámetro con un valor que se pueda modificar, como se muestra en el ejemplo. El ejemplo pasa el parámetro de filtro, junto con los demás parámetros que se requieran para descargar las inserciones incrementales.

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

Jerarquía de herencia

System.Object
  Microsoft.Synchronization.Data.SyncParameter

Seguridad para subprocesos

Todos los miembros (Compartidos en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

SyncParameter Miembros
Microsoft.Synchronization.Data Espacio de nombres