Конструктор SyncParameter (String, Object)

Инициализирует новый экземпляр класса SyncParameter по имени и значению параметра.

Пространство имен: Microsoft.Synchronization.Data
Сборка: Microsoft.Synchronization.Data (в microsoft.synchronization.data.dll)

Синтаксис

'Декларация
Public Sub New ( _
    name As String, _
    value As Object _
)
'Применение
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
)

Параметры

  • name
    Имя параметра.
  • value
    Значение параметра.

Замечания

Параметры синхронизации обычно используются для передачи агенту синхронизации сведений о фильтрации. Затем эти параметры используются в командах для адаптера синхронизации.

Пример

Следующий пример кода представляет собой класс, который является производным от класса SyncAgent. В этом коде создается объект SyncParameter, задающий значение для параметра @SalesPerson. В приложении это значение может соответствовать идентификатору входа или поступать из других введенных пользователем данных. Чтобы просмотреть код в контексте полного примера, см. раздел Как фильтровать строки и столбцы.

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

Следующий пример кода представляет собой класс, который является производным от класса DbServerSyncProvider. Этот код определяет, какие вставленные столбцы и строки будут загружаться для таблицы Customer. Значение параметра SalesPerson может быть жестко задано в коде. Однако обычно используется параметр, значение которого может меняться, как показано в данном примере. В примере параметр фильтра передается вместе с другими параметрами, необходимыми для загрузки добавочных операций вставки.

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

См. также

Справочник

Класс SyncParameter
Элементы SyncParameter
Пространство имен Microsoft.Synchronization.Data