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 所指定的變更。