共用方式為


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
)
member GetChangeApplicationContext : 
        sourceChange:ItemChange * 
        destinationVersion:ItemChange -> ChangeApplicationContext 
public function GetChangeApplicationContext(
    sourceChange : ItemChange, 
    destinationVersion : ItemChange
) : ChangeApplicationContext

參數

  • sourceChange
    型別:Microsoft.Synchronization. . :: . .ItemChange
    從來源提供者接收的變更。當變更批次屬於復原同步處理的一部分時,可為 nullNothingnullptrunitnull 參考 (在 Visual Basic 中為 Nothing)。
  • destinationVersion
    型別:Microsoft.Synchronization. . :: . .ItemChange
    目的地複寫中的 sourceChange 版本。當目的地複寫沒有 sourceChange 的版本時,可為 nullNothingnullptrunitnull 參考 (在 Visual Basic 中為 Nothing)。

傳回值

型別:Microsoft.Synchronization. . :: . .ChangeApplicationContext
傳回可用來處理變更的物件。

例外

例外狀況 條件
ActiveChangeApplicationContextException

ChangeApplicationContext 物件已經使用中。您必須處理使用中 ChangeApplicationContext 物件,直到其 ChangeApplicationAction 設定為 Finished 為止,然後才能處理其他變更。

ChangeNeedsKnowledgeException

sourceChange 不包含建立方式知識。

ChangeVersionNotInKnowledgeException

sourceChange 的更新版本或建立版本沒有包含在其建立方式知識中。

ChangeUnitCountMismatchException

sourceChange 和 destinationVersion 包含不同的變更單位數目。

SyncIdFormatMismatchException

指定之知識物件的識別碼格式結構描述與初始化這個物件時所指定的識別碼格式結構描述不符。

SyncInvalidOperationException

變更套用並未啟動,或者 sourceChange 已經報告成套用成功。

ItemHasChangeUnitsException

sourceChange 或 destinationVersion 包含變更單位,而其他項目卻沒有包含。

ChangeNotExpectedException

sourceChange 和 destinationVersion 參考不同的項目識別碼。

備註

目的地提供者通常會針對從來源提供者所傳送的每個變更呼叫這個方法一次。所傳回的 ChangeApplicationContext 物件可用來執行衝突偵測、衝突解決,以及判斷目的地提供者應該如何套用 sourceChange 所指定的變更。

請參閱

參考

ChangeApplicationServices類別

ChangeApplicationServices 成員

Microsoft.Synchronization 命名空間