다음을 통해 공유


SyncParameter 클래스

클라이언트에서 서버로 보낸 정보를 캡슐화합니다.

네임스페이스: Microsoft.Synchronization.Data
어셈블리: microsoft.synchronization.data.dll의 Microsoft.Synchronization.Data

구문

‘선언
<SerializableAttribute> _
Public Class SyncParameter
‘사용 방법
Dim instance As SyncParameter
[SerializableAttribute] 
public class SyncParameter
[SerializableAttribute] 
public ref class SyncParameter
/** @attribute SerializableAttribute() */ 
public class SyncParameter
SerializableAttribute 
public class SyncParameter

주의

일반적으로 동기화 매개 변수는 필터링 정보를 동기화 에이전트에 전달하는 데 사용됩니다. 이러한 매개 변수는 동기화 어댑터에 대한 명령에서 사용됩니다.

예제

다음 코드 예제는 SyncAgent에서 파생된 클래스에서 제공된 것입니다. 이 코드에서는 @SalesPerson 매개 변수의 값을 지정하는 SyncParameter 개체를 만듭니다. 응용 프로그램에서 이 값은 로그인 ID 또는 기타 사용자 입력에서 생성될 수 있습니다. 전체 예제의 맥락에서 이 코드를 보려면 방법: 행 및 열 필터링을 참조하십시오.

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

상속 계층 구조

System.Object
  Microsoft.Synchronization.Data.SyncParameter

스레드로부터의 안전성

이 유형의 모든 public static(Visual Basic의 경우 Shared ) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.

참고 항목

참조

SyncParameter 멤버
Microsoft.Synchronization.Data 네임스페이스