ChangeApplicationServices.GetChangeApplicationContext 方法

获取表示要应用的当前变更的对象。

命名空间: Microsoft.Synchronization
程序集: Microsoft.Synchronization(在 microsoft.synchronization.dll 中)

语法

声明
Public Function GetChangeApplicationContext ( _
    sourceChange As ItemChange, _
    destinationVersion As ItemChange _
) As ChangeApplicationContext
用法
Dim instance As ChangeApplicationServices
Dim sourceChange As ItemChange
Dim destinationVersion As ItemChange
Dim returnValue As ChangeApplicationContext

returnValue = instance.GetChangeApplicationContext(sourceChange, destinationVersion)
public ChangeApplicationContext GetChangeApplicationContext (
    ItemChange sourceChange,
    ItemChange destinationVersion
)
public:
ChangeApplicationContext^ GetChangeApplicationContext (
    ItemChange^ sourceChange, 
    ItemChange^ destinationVersion
)
public ChangeApplicationContext GetChangeApplicationContext (
    ItemChange sourceChange, 
    ItemChange destinationVersion
)
public function GetChangeApplicationContext (
    sourceChange : ItemChange, 
    destinationVersion : ItemChange
) : ChangeApplicationContext

参数

  • sourceChange
    从源提供程序接收的变更。当变更批是恢复同步的组成部分时,可为 null 引用(在 Visual Basic 中为 Nothing)。
  • destinationVersion
    目标副本中的 sourceChange 的版本。当目标副本没有 sourceChange 的版本时,可为 null 引用(在 Visual Basic 中为 Nothing)。

返回值

返回一个可用于处理变更的对象。

异常

异常类型 条件

ActiveChangeApplicationContextException

一个 ChangeApplicationContext 对象已处于活动状态。必须先处理活动的 ChangeApplicationContext 对象,直到其 ChangeApplicationAction 属性设置为 Finished,然后才能处理另一个变更。

ChangeNeedsKnowledgeException

sourceChange 不包含生成知识。

ChangeVersionNotInKnowledgeException

sourceChange 的更新版本或创建版本不包含在它的生成知识中。

ChangeUnitCountMismatchException

sourceChange 和 destinationVersion 包含的变更单位数不同。

SyncIdFormatMismatchException

指定知识对象的 ID 格式架构与初始化此对象时指定的 ID 格式架构不匹配。

SyncInvalidOperationException

变更应用未开始或者 sourceChange 已报告为成功应用。

ItemHasChangeUnitsException

sourceChange 和 destinationVersion 中只有一个包含变更单位。

ChangeNotExpectedException

sourceChange 和 destinationVersion 引用了不同的项 ID。

备注

目标提供程序通常对从源提供程序发送的每个变更调用一次此方法。返回的 ChangeApplicationContext 对象可用于执行冲突检测和冲突解决,并可用于确定目标提供程序应如何应用 sourceChange 指定的变更。

请参阅

参考

ChangeApplicationServices 类
ChangeApplicationServices 成员
Microsoft.Synchronization 命名空间