SyncCallbacks.ItemConstraint イベント

制約の競合が報告されると、衝突競合の解決方法が ApplicationDefined に設定されている場合の衝突競合や、衝突以外のすべての制約の競合に対して発生します。

名前空間: Microsoft.Synchronization
アセンブリ: Microsoft.Synchronization (microsoft.synchronization.dll 内)

構文

'宣言
Public Event ItemConstraint As EventHandler(Of ItemConstraintEventArgs)
'使用
Dim instance As SyncCallbacks
Dim handler As EventHandler(Of ItemConstraintEventArgs)

AddHandler instance.ItemConstraint, handler

public event EventHandler<ItemConstraintEventArgs> ItemConstraint

public:
event EventHandler<ItemConstraintEventArgs^>^ ItemConstraint {
    void add (EventHandler<ItemConstraintEventArgs^>^ value);
    void remove (EventHandler<ItemConstraintEventArgs^>^ value);
}

/** @event */
public void add_ItemConstraint (EventHandler<ItemConstraintEventArgs> value)

/** @event */
public void remove_ItemConstraint (EventHandler<ItemConstraintEventArgs> value)

JScript supports the use of events, but not the declaration of new ones.

解説

この通知は、制約の競合に対してカスタム競合解決を実行する際にアプリケーションで使用できます。アプリケーションでこれを実行するには、イベント ハンドラーに送信される ItemConstraintEventArgs オブジェクトの内容を検査および処理した後、このメソッドから返される前に SetResolutionAction を呼び出して、競合の解決アクションを設定します。

ItemConstraintEventArgs オブジェクトの ConstraintConflictReason プロパティが Collision 以外の値に設定されている場合、解決アクションは SkipChange または SaveConflict のどちらかに設定する必要があります。

例

次の例では、ItemConstraint イベントのハンドラーを実装します。ハンドラーによって競合している項目がユーザーに示され、ユーザーの応答に基づいて制約の競合の解決アクションが設定されます。

Private Sub HandleItemConstraint(ByVal sender As [Object], ByVal args As ItemConstraintEventArgs)
    If ConstraintConflictReason.Collision = args.ConstraintConflictReason Then
        ' Display the two items that are in conflict and solicit a resolution from the user.
        Dim srcContact As New Contact(DirectCast(args.SourceChangeData, String()))
        Dim destContact As New Contact(DirectCast(args.DestinationChangeData, String()))
        Dim msg As String = ("Source change is " & srcContact.ToString() & vbLf & "Destination change is ") & destContact.ToString() & vbLf & "Click Yes to rename the source change and apply it." & vbLf & "Click No to rename the destination item and apply the source change." & vbLf & "Click Cancel to delete the destination item and apply the source change."
        Dim ccDlg As New ConstraintConflictDlg(msg)
        ccDlg.ShowDialog()

        ' Set the resolution action based on the user's response.
        args.SetResolutionAction(ccDlg.Resolution)
    Else
        args.SetResolutionAction(ConstraintConflictResolutionAction.SaveConflict)
    End If
End Sub

void HandleItemConstraint(Object sender, ItemConstraintEventArgs args)
{
    if (ConstraintConflictReason.Collision == args.ConstraintConflictReason)
    {
        // Display the two items that are in conflict and solicit a resolution from the user.
        Contact srcContact = new Contact((string[])args.SourceChangeData);
        Contact destContact = new Contact((string[])args.DestinationChangeData);
        string msg = "Source change is " + srcContact.ToString() +
                   "\nDestination change is " + destContact.ToString() +
                   "\nClick Yes to rename the source change and apply it." +
                   "\nClick No to rename the destination item and apply the source change." +
                   "\nClick Cancel to delete the destination item and apply the source change.";
        ConstraintConflictDlg ccDlg = new ConstraintConflictDlg(msg);
        ccDlg.ShowDialog();

        // Set the resolution action based on the user's response.
        args.SetResolutionAction(ccDlg.Resolution);
    }
    else 
    {
        args.SetResolutionAction(ConstraintConflictResolutionAction.SaveConflict);
    }
}

参照

リファレンス

SyncCallbacks クラス
SyncCallbacks メンバー
Microsoft.Synchronization 名前空間

概念

制約の競合の検出および解決