BusinessLogicModule.UpdateConflictsHandler Method

Optional method that implements the custom business logic invoked when conflicting UPDATE statements occur at the Publisher and at the Subscriber.

Namespace:  Microsoft.SqlServer.Replication.BusinessLogicSupport
Assembly:  Microsoft.SqlServer.Replication.BusinessLogicSupport (in Microsoft.SqlServer.Replication.BusinessLogicSupport.dll)

Syntax

'Declaration
Public Overridable Function UpdateConflictsHandler ( _
    publisherDataSet As DataSet, _
    subscriberDataSet As DataSet, _
    ByRef customDataSet As DataSet, _
    ByRef conflictLogType As ConflictLogType, _
    ByRef customConflictMessage As String, _
    ByRef historyLogLevel As Integer, _
    ByRef historyLogMessage As String _
) As ActionOnUpdateConflict
'Usage
Dim instance As BusinessLogicModule 
Dim publisherDataSet As DataSet 
Dim subscriberDataSet As DataSet 
Dim customDataSet As DataSet 
Dim conflictLogType As ConflictLogType 
Dim customConflictMessage As String 
Dim historyLogLevel As Integer 
Dim historyLogMessage As String 
Dim returnValue As ActionOnUpdateConflict 

returnValue = instance.UpdateConflictsHandler(publisherDataSet, _
    subscriberDataSet, customDataSet, _
    conflictLogType, customConflictMessage, _
    historyLogLevel, historyLogMessage)

public virtual ActionOnUpdateConflict UpdateConflictsHandler(
    DataSet publisherDataSet,
    DataSet subscriberDataSet,
    ref DataSet customDataSet,
    ref ConflictLogType conflictLogType,
    ref string customConflictMessage,
    ref int historyLogLevel,
    ref string historyLogMessage
)

public:
virtual ActionOnUpdateConflict UpdateConflictsHandler(
    DataSet^ publisherDataSet, 
    DataSet^ subscriberDataSet, 
    DataSet^% customDataSet, 
    ConflictLogType% conflictLogType, 
    String^% customConflictMessage, 
    int% historyLogLevel, 
    String^% historyLogMessage
)

abstract UpdateConflictsHandler : 
        publisherDataSet:DataSet * 
        subscriberDataSet:DataSet * 
        customDataSet:DataSet byref * 
        conflictLogType:ConflictLogType byref * 
        customConflictMessage:string byref * 
        historyLogLevel:int byref * 
        historyLogMessage:string byref -> ActionOnUpdateConflict  
override UpdateConflictsHandler : 
        publisherDataSet:DataSet * 
        subscriberDataSet:DataSet * 
        customDataSet:DataSet byref * 
        conflictLogType:ConflictLogType byref * 
        customConflictMessage:string byref * 
        historyLogLevel:int byref * 
        historyLogMessage:string byref -> ActionOnUpdateConflict

public function UpdateConflictsHandler(
    publisherDataSet : DataSet, 
    subscriberDataSet : DataSet, 
    customDataSet : DataSet, 
    conflictLogType : ConflictLogType, 
    customConflictMessage : String, 
    historyLogLevel : int, 
    historyLogMessage : String
) : ActionOnUpdateConflict

Parameters

• publisherDataSet
  Type: System.Data.DataSet
  Dataset representing the Publisher data.

• subscriberDataSet
  Type: System.Data.DataSet
  Dataset representing the Subscriber data.

• customDataSet
  Type: System.Data.DataSet%
  Dataset implemented by the custom business logic.

• conflictLogType
  Type: Microsoft.SqlServer.Replication.BusinessLogicSupport.ConflictLogType%
  ConflictLogType requested by the custom business logic handler.

• customConflictMessage
  Type: System.String%
  Conflict message returned by the custom business logic handler.

• historyLogLevel
  Type: System.Int32%
  Log level of the custom message returned by the custom business logic handler.

• historyLogMessage
  Type: System.String%
  Log message provided by custom business logic handler. The log message gets written to the distribution database.

Return Value

Type: Microsoft.SqlServer.Replication.BusinessLogicSupport.ActionOnUpdateConflict
The ActionOnUpdateConflict action that will be taken by the process after the custom business logic handler has executed.

See Also

Reference

BusinessLogicModule Class

Microsoft.SqlServer.Replication.BusinessLogicSupport Namespace

Other Resources

Execute Business Logic During Merge Synchronization

Implement a Business Logic Handler for a Merge Article