IDataObject Interface

Provides a format-independent mechanism for transferring data.

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

type IDataObject =  interface end

  NameDescription
Public methodGetData(String)Retrieves a data object in a specified format; the data format is specified by a string.
Public methodGetData(Type)Retrieves a data object in a specified format; the data format is specified by a Type object.
Public methodGetData(String, Boolean)Retrieves a data object in a specified format, optionally converting the data to the specified format.
Public methodGetDataPresent(String)Checks to see whether the data is available in, or can be converted to, a specified format; the data format is specified by a string.
Public methodGetDataPresent(Type)Checks to see whether the data is available in, or can be converted to, a specified format. The data format is specified by a Type object.
Public methodGetDataPresent(String, Boolean)Checks to see whether the data is available in, or can be converted to, a specified format. A Boolean flag indicates whether to check if the data can be converted to the specified format, if it is not available in that format.
Public methodGetFormats()Returns a list of all formats that the data in this data object is stored in, or can be converted to.
Public methodGetFormats(Boolean)Returns a list of all formats that the data in this data object is stored in. A Boolean flag indicates whether or not to also include formats that the data can be automatically converted to.
Public methodSetData(Object)Stores the specified data in this data object, automatically converting the data format from the source object type.
Public methodSetData(String, Object)Stores the specified data in this data object, along with one or more specified data formats. The data format is specified by a string.
Public methodSetData(Type, Object)Stores the specified data in this data object, along with one or more specified data formats. The data format is specified by a Type class.
Public methodSetData(String, Object, Boolean)Stores the specified data in this data object, along with one or more specified data formats. This overload includes a Boolean flag to indicate whether the data may be converted to another format on retrieval.
Top

The IDataObject interface is used by the Clipboard class for data transfer operations like drag-and-drop.

When implemented by a class, the IDataObject methods enable a single data object to offer data in multiple formats. Offering data in multiple formats tends to make the data usable by a wider variety of applications than if only a single data format were supported.

The DataObject class provides a basic implementation of the IDataObject interface.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft