IDataObject Interface

Definition

Namespace:

System.Runtime.InteropServices.ComTypes

Assembly:

System.Runtime.InteropServices.dll

Important

This API is not CLS-compliant.

Provides the managed definition of the IDataObject interface.

public interface class IDataObject

[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
[System.CLSCompliant(false)]
public interface IDataObject

[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)>]
[<System.CLSCompliant(false)>]
type IDataObject = interface

Public Interface IDataObject

Derived

System.Windows.DataObject

Attributes

InterfaceTypeAttribute CLSCompliantAttribute

Remarks

For more information, see IDataObject interface.

The common language runtime throws an exception when a COM method in native code returns an HRESULT. For more information, see How to: Map HRESULTs and Exceptions.

Methods

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Creates a connection between a data object and an advisory sink. This method is called by an object that supports an advisory sink and enables the advisory sink to be notified of changes in the object's data.
DUnadvise(Int32)	Destroys a notification connection that had been previously established.
EnumDAdvise(IEnumSTATDATA)	Creates an object that can be used to enumerate the current advisory connections.
EnumFormatEtc(DATADIR)	Creates an object for enumerating the FORMATETC structures for a data object. These structures are used in calls to GetData(FORMATETC, STGMEDIUM) or SetData(FORMATETC, STGMEDIUM, Boolean).
GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Provides a standard FORMATETC structure that is logically equivalent to a more complex structure. Use this method to determine whether two different FORMATETC structures would return the same data, removing the need for duplicate rendering.
GetData(FORMATETC, STGMEDIUM)	Obtains data from a source data object. The GetData(FORMATETC, STGMEDIUM) method, which is called by a data consumer, renders the data described in the specified FORMATETC structure and transfers it through the specified STGMEDIUM structure. The caller then assumes responsibility for releasing the STGMEDIUM structure.
GetDataHere(FORMATETC, STGMEDIUM)	Obtains data from a source data object. This method, which is called by a data consumer, differs from the GetData(FORMATETC, STGMEDIUM) method in that the caller must allocate and free the specified storage medium.
QueryGetData(FORMATETC)	Determines whether the data object is capable of rendering the data described in the FORMATETC structure. Objects attempting a paste or drop operation can call this method before calling GetData(FORMATETC, STGMEDIUM) to get an indication of whether the operation may be successful.
SetData(FORMATETC, STGMEDIUM, Boolean)	Transfers data to the object that implements this method. This method is called by an object that contains a data source.