ItemConstraint-Ereignis
Tritt beim Melden eines Einschränkungskonflikts für Kollisionskonflikte auf, wenn die Richtlinie zur Kollisionskonfliktauflösung auf ApplicationDefined festgelegt ist, und für alle Nicht-Kollisionseinschränkungskonflikte.
Namespace: Microsoft.Synchronization
Assembly: Microsoft.Synchronization (in Microsoft.Synchronization.dll)
Syntax
'Declaration
Public Event ItemConstraint As EventHandler(Of ItemConstraintEventArgs)
'Usage
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);
}
member ItemConstraint : IEvent<EventHandler<ItemConstraintEventArgs>,
ItemConstraintEventArgs>
Hinweise
Diese Benachrichtigung kann von einer Anwendung verwendet werden, um eine benutzerdefinierte Konfliktauflösung für Einschränkungskonflikte auszuführen. Hierzu überprüft und verarbeitet die Anwendung den Inhalt des ItemConstraintEventArgs-Objekts, das an den Ereignishandler gesendet wird, und legt dann die Auflösungsaktion für den Konflikt fest, indem SetResolutionAction vor der Rückgabe von dieser Methode aufgerufen wird.
Wenn die ConstraintConflictReason-Eigenschaft des ItemConstraintEventArgs-Objekts auf einen anderen Wert als Collision festgelegt ist, muss die Auflösungsaktion auf SkipChange oder SaveConflict festgelegt werden.
Beispiele
Im folgenden Beispiel wird ein Handler für das ItemConstraint-Ereignis implementiert. Der Handler zeigt dem Benutzer die Konflikt verursachenden Elemente an und legt die Einschränkungs-Konfliktauflösungsaktion auf Grundlage der Antwort des Benutzers fest.
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);
}
}
Siehe auch
Verweis
Microsoft.Synchronization-Namespace