BusinessLogicModule.UpdateErrorHandler-Methode

Optional method that implements the custom business logic invoked when an error occurs at the time an UPDATE statement is being uploaded or downloaded.

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

Syntax

'Declaration
Public Overridable Function UpdateErrorHandler ( _
    updateSource As SourceIdentifier, _
    updatedDataSet As DataSet, _
    ByRef errorLogType As ErrorLogType, _
    ByRef customErrorMessage As String, _
    errorCode As Integer, _
    errorMessage As String, _
    ByRef historyLogLevel As Integer, _
    ByRef historyLogMessage As String _
) As ActionOnDataError
'Usage
Dim instance As BusinessLogicModule 
Dim updateSource As SourceIdentifier 
Dim updatedDataSet As DataSet 
Dim errorLogType As ErrorLogType 
Dim customErrorMessage As String 
Dim errorCode As Integer 
Dim errorMessage As String 
Dim historyLogLevel As Integer 
Dim historyLogMessage As String 
Dim returnValue As ActionOnDataError 

returnValue = instance.UpdateErrorHandler(updateSource, _
    updatedDataSet, errorLogType, customErrorMessage, _
    errorCode, errorMessage, historyLogLevel, _
    historyLogMessage)

public virtual ActionOnDataError UpdateErrorHandler(
    SourceIdentifier updateSource,
    DataSet updatedDataSet,
    ref ErrorLogType errorLogType,
    ref string customErrorMessage,
    int errorCode,
    string errorMessage,
    ref int historyLogLevel,
    ref string historyLogMessage
)

public:
virtual ActionOnDataError UpdateErrorHandler(
    SourceIdentifier updateSource, 
    DataSet^ updatedDataSet, 
    ErrorLogType% errorLogType, 
    String^% customErrorMessage, 
    int errorCode, 
    String^ errorMessage, 
    int% historyLogLevel, 
    String^% historyLogMessage
)

abstract UpdateErrorHandler : 
        updateSource:SourceIdentifier * 
        updatedDataSet:DataSet * 
        errorLogType:ErrorLogType byref * 
        customErrorMessage:string byref * 
        errorCode:int * 
        errorMessage:string * 
        historyLogLevel:int byref * 
        historyLogMessage:string byref -> ActionOnDataError  
override UpdateErrorHandler : 
        updateSource:SourceIdentifier * 
        updatedDataSet:DataSet * 
        errorLogType:ErrorLogType byref * 
        customErrorMessage:string byref * 
        errorCode:int * 
        errorMessage:string * 
        historyLogLevel:int byref * 
        historyLogMessage:string byref -> ActionOnDataError

public function UpdateErrorHandler(
    updateSource : SourceIdentifier, 
    updatedDataSet : DataSet, 
    errorLogType : ErrorLogType, 
    customErrorMessage : String, 
    errorCode : int, 
    errorMessage : String, 
    historyLogLevel : int, 
    historyLogMessage : String
) : ActionOnDataError

Parameter

• updateSource
  Typ: Microsoft.SqlServer.Replication.BusinessLogicSupport.SourceIdentifier
  SourceIdentifier that indicates whether the source of the update that generated the error is the Publisher or the Subscriber.

• updatedDataSet
  Typ: System.Data.DataSet
  Dataset representing the UPDATE statement that caused the error.

• errorLogType
  Typ: Microsoft.SqlServer.Replication.BusinessLogicSupport.ErrorLogType%
  ErrorLogType output parameter that controls how replication logs the error. This parameter is used only if the return value is AcceptCustomErrorBehavior.

• customErrorMessage
  Typ: System.String%
  Output parameter used to return a custom error message. This parameter is used only if the return value is AcceptCustomErrorBehavior.

• errorCode
  Typ: System.Int32
  Error code that corresponds to the underlying replication error that occurred.

• errorMessage
  Typ: System.String
  Error message text that corresponds to the underlying replication error that occurred.

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

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

Rückgabewert

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

Siehe auch

Verweis

BusinessLogicModule Klasse

Microsoft.SqlServer.Replication.BusinessLogicSupport-Namespace

Andere Ressourcen

Ausführen der Geschäftslogik während der Mergesynchronisierung

Implementieren eines Geschäftslogikhandlers für einen Mergeartikel