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 オブジェクトが既にアクティブです。別の変更を処理するには、ChangeApplicationAction プロパティが Finished に設定されるまでアクティブな ChangeApplicationContext オブジェクトを処理する必要があります。 |
| ChangeNeedsKnowledgeException | sourceChange に、関連付けられているナレッジが含まれていません。 |
| ChangeVersionNotInKnowledgeException | sourceChange の更新バージョンまたは作成バージョンが、関連付けられているナレッジに含まれていません。 |
| ChangeUnitCountMismatchException | sourceChange と destinationVersion に含まれている変更単位の数が異なります。 |
| SyncIdFormatMismatchException | 指定されたナレッジ オブジェクトの ID 形式スキーマが、このオブジェクトを初期化したときに指定された ID 形式スキーマと一致しません。 |
| SyncInvalidOperationException | 変更の適用が開始されていないか、sourceChange が正常に適用されたことが既に報告されています。 |
| ItemHasChangeUnitsException | sourceChange または destinationVersion のうち、一方には変更単位が含まれていますが、他方には変更単位が含まれていません。 |
| ChangeNotExpectedException | sourceChange と destinationVersion が異なる項目 ID を参照しています。 |
説明
通常、このメソッドは、同期元プロバイダーから送信される各変更につき、同期先プロバイダーから 1 回呼び出されます。返された ChangeApplicationContext オブジェクトを使用すると、競合の検出や解決を行うことも、sourceChange によって指定された変更を同期先プロバイダーがどのように適用するかを決定することもできます。