CommandBindingsCollectionAddSynchronizedPropertyBinding(Object, String, String, Boolean, Object) Method

public ICommandBinding AddSynchronizedPropertyBinding(
	Object source,
	string sourcePropertyName,
	string targetPropertyName,
	bool awaitCompletion,
	params Object[]? targets
)

Public Function AddSynchronizedPropertyBinding ( 
	source As Object,
	sourcePropertyName As String,
	targetPropertyName As String,
	awaitCompletion As Boolean,
	ParamArray targets As Object()
) As ICommandBinding

public:
ICommandBinding^ AddSynchronizedPropertyBinding(
	Object^ source, 
	String^ sourcePropertyName, 
	String^ targetPropertyName, 
	bool awaitCompletion, 
	... array<Object^>^ targets
)

member AddSynchronizedPropertyBinding : 
        source : Object * 
        sourcePropertyName : string * 
        targetPropertyName : string * 
        awaitCompletion : bool * 
        targets : Object[] -> ICommandBinding 

Parameters

source  Object

The source object, whose property specified by the sourcePropertyName parameter is observed.

sourcePropertyName  String

The name of the property, whose change is observed.

targetPropertyName  String

The name of the property in the target object(s).

awaitCompletion  Boolean

to block the thread of the triggering event until setting a target property is completed; otherwise, .

targets  Object

The targets to be updated. If the concrete instances to update have to be returned when the change occurs use the ICommandBinding.AddTarget method on the result ICommandBinding instance.

Return Value

This method uses a prepared command internally, which is bound to the PropertyChanged event of the specified source object. Or, when source does not implement INotifyPropertyChanged, then an event of name sourcePropertyName postfixed by Changed should exist on the source object.

The ICommandState, which is created for the underlying command contains the specified property names. Do not remove these state entries; otherwise, the command will throw an InvalidOperationException when executed.

The property with targetPropertyName will be set in the specified targets immediately when this method is called. The targets, which are added later by the ICommandBinding.AddTarget methods, are set only when the PropertyChanged or sourcePropertyNameChanged event occurs on the source object.

Reference