The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

DataObject.AddPastingHandler Method

Adds a Pasting event handler to a specified dependency object.

Namespace: System.Windows
Assembly: PresentationCore (in presentationcore.dll)

public static void AddPastingHandler (
	DependencyObject element,
	DataObjectPastingEventHandler handler
public static void AddPastingHandler (
	DependencyObject element, 
	DataObjectPastingEventHandler handler
public static function AddPastingHandler (
	element : DependencyObject, 
	handler : DataObjectPastingEventHandler
You cannot use methods in XAML.



The dependency object (a UIElement or ContentElement) to which to add the event handler.


A delegate that references the handler method to add.

Use this event to inspect a data object before the data is pasted, and possibly to decide on an alternate course of action, such as:

  • Cancel the Paste - Cancel the entire paste operation by calling the CancelCommand method.

  • Select an Alternate Format - Change the selected paste format by specifying a new value for the FormatToApply property. The newly selected format must by supported by the data object to be pasted.


    If the paste format is changed, ensure that the paste target supports the newly specified format.

  • Insert a New Format - If you determine that the paste data object does not support the desired format, update the data object to include a version of the data in the desired format. Custom data converters are often used as part of this process.

Changing the content of a paste data object (DataObject) does not change the data stored on the system Clipboard; any such changes will apply only to the data object associated with the associated paste command.

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.

.NET Framework

Supported in: 3.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2014 Microsoft