Export (0) Print
Expand All

Binding.SourceUpdated Attached Event

Occurs when a value is transferred from the binding target to the binding source, but only for bindings with the NotifyOnSourceUpdated value set to true.

Namespace: System.Windows.Data
Assembly: PresentationFramework (in PresentationFramework.dll)
XML Namespace:  http://schemas.microsoft.com/winfx/2006/xaml/presentation

See Binding.AddSourceUpdatedHandler, Binding.RemoveSourceUpdatedHandler
See Binding.AddSourceUpdatedHandler, Binding.RemoveSourceUpdatedHandler
See Binding.AddSourceUpdatedHandler, Binding.RemoveSourceUpdatedHandler
<object Binding.SourceUpdated="EventHandler<DataTransferEventArgs>" .../>

Identifier field

SourceUpdatedEvent

Routing strategy

Bubbling

Delegate

Generic EventHandler, type constrained to DataTransferEventArgs.

This example shows how to set up to be notified when the binding target (target) or the binding source (source) property of a binding has been updated.

Windows Presentation Foundation (WPF) raises a data update event each time that the binding source or target has been updated. Internally, this event is used to inform the user interface (UI) that it should update, because the bound data has changed. Note that for these events to work, and also for one-way or two-way binding to work properly, you need to implement your data class using the INotifyPropertyChanged interface. For more information, see Implement Property Change Notification.

Set the NotifyOnTargetUpdated or NotifyOnSourceUpdated property (or both) to true in the binding. The handler you provide to listen for this event must be attached directly to the element where you want to be informed of changes, or to the overall data context if you want to be aware that anything in the context has changed.

For the complete sample, see Binding Modes Sample.

Here is an example that shows how to set up for notification when a target property has been updated.

<TextBlock Grid.Row="1" Grid.Column="1" Name="RentText"
  Text="{Binding Path=Rent, Mode=OneWay, NotifyOnTargetUpdated=True}"
  TargetUpdated="OnTargetUpdated"/>

You can then assign a handler based on the EventHandler<T> delegate, OnTargetUpdated in this example, to handle the event:

public void OnTargetUpdated(Object sender, DataTransferEventArgs args)
{

  // Handle event

...

}

Parameters of the event can be used to determine details about the property that changed (such as the type or the specific element if the same handler is attached to more than one element), which can be useful if there are multiple bound properties on a single element.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Community Additions

ADD
Show:
© 2015 Microsoft