CommandCreateSynchronizedPropertyBinding(INotifyPropertyChanged, String, String, FuncObject, Object, Boolean, Object) Method

public static ICommandBinding CreateSynchronizedPropertyBinding(
	this INotifyPropertyChanged source,
	string sourcePropertyName,
	string targetPropertyName,
	Func<Object?, Object?>? format,
	bool awaitCompletion,
	params Object[]? targets
)

<ExtensionAttribute>
Public Shared Function CreateSynchronizedPropertyBinding ( 
	source As INotifyPropertyChanged,
	sourcePropertyName As String,
	targetPropertyName As String,
	format As Func(Of Object, Object),
	awaitCompletion As Boolean,
	ParamArray targets As Object()
) As ICommandBinding

public:
[ExtensionAttribute]
static ICommandBinding^ CreateSynchronizedPropertyBinding(
	INotifyPropertyChanged^ source, 
	String^ sourcePropertyName, 
	String^ targetPropertyName, 
	Func<Object^, Object^>^ format, 
	bool awaitCompletion, 
	... array<Object^>^ targets
)

[<ExtensionAttribute>]
static member CreateSynchronizedPropertyBinding : 
        source : INotifyPropertyChanged * 
        sourcePropertyName : string * 
        targetPropertyName : string * 
        format : Func<Object, Object> * 
        awaitCompletion : bool * 
        targets : Object[] -> ICommandBinding 

Parameters

source  INotifyPropertyChanged

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).

format  FuncObject, Object

If not , then can be used to format the value to be set in the targets.

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

Usage Note

This method uses a prepared command internally, which is bound to the PropertyChanged event of the specified source object.

The ICommandState, which is created for the underlying command contains the specified property names and formatparameters. 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 event occurs on the source object.

Reference