IDataObject 接口

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

为传送数据提供与格式无关的机制。

public interface class IDataObject

[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject

public interface IDataObject

[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interface

type IDataObject = interface

Public Interface IDataObject

派生

System.Windows.Forms.DataObject

属性

ComVisibleAttribute

注解

该 IDataObject 接口由 Clipboard 类和拖放操作使用。

在类中实现时， IDataObject 方法允许用户在类的实例中以多种格式存储数据。 以多个格式存储数据会增加目标应用程序（你可能不知道的格式要求）可以检索存储的数据的可能性。 若要在实例 IDataObject中存储数据，请调用 SetData 该方法并在参数中 format 指定数据格式。 autoConvert如果不希望在检索数据时将存储的数据转换为另一种格式，请将参数false设置为该参数。 在多个格式存储数据的一个实例IDataObject上多次调用SetData。

通过调用GetData该方法并在参数中format指定数据格式来检索存储的数据IDataObject。 将 autoConvert 参数设置为 false 仅检索以指定格式存储的数据。 若要将存储的数据转换为指定格式，请设置为autoConvert``true或不使用autoConvert。

若要确定存储在其中 IDataObject的数据的格式，请使用以下 IDataObject 方法。

• GetFormats调用该方法以检索数据可用的所有格式的数组。 将 autoConvert 参数设置为 false 仅获取存储数据的格式。 若要获取数据可用的所有格式，请设置为autoConvert``true或不使用此参数。

• GetDataPresent调用该方法以确定存储的数据是否以特定格式提供。 如果不希望存储的数据转换为指定格式，请将 autoConvert 参数设置为 false。

请参阅此 DataObject 接口的实现的类。 DataFormats请参阅预定义数据格式的Clipboard类。

方法

GetData(String)	检索与指定的数据格式关联的数据。
GetData(String, Boolean)	检索与指定数据格式相关联的数据，并使用一个布尔值确定是否将数据转换成该格式。
GetData(Type)	检索与指定的类类型格式关联的数据。
GetDataPresent(String)	确定此实例中存储的数据是否与指定的格式关联，或是否可以转换成指定的格式。
GetDataPresent(String, Boolean)	确定该实例中存储的数据是否与指定格式关联，同时使用一个布尔值确定是否将数据转换成此格式。
GetDataPresent(Type)	确定此实例中存储的数据是否与指定的格式关联，或是否可以转换成指定的格式。
GetFormats()	返回存储在此实例中的数据所关联的或可以转换为的所有格式的列表。
GetFormats(Boolean)	获取该实例中存储的数据所关联或可转换到的所有格式的列表，同时使用一个布尔值确定是检索数据可转换到的所有格式，还是只检索本机数据格式。
SetData(Object)	使用此格式的数据类存储此实例中的指定数据。
SetData(String, Boolean, Object)	在该实例中存储指定的数据及其关联格式，同时使用一个布尔值指定数据能否转换成另一格式。
SetData(String, Object)	存储此实例中的指定数据及其关联格式。
SetData(Type, Object)	存储此实例中的指定数据及其关联类类型。

另请参阅

• DataObject
• DataFormats