IDataObject 介面

定義

提供不受格式影響的資料傳送機制。Provides a format-independent mechanism for transferring data.

public interface class IDataObject
public interface IDataObject
[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject
type IDataObject = interface
[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interface
Public Interface IDataObject
衍生
屬性

備註

IDataObject介面是由 Clipboard 類別和拖放作業所使用。The IDataObject interface is used by the Clipboard class and in drag-and-drop operations.

在類別中執行時, IDataObject 方法可讓使用者將多個格式的資料儲存在類別的實例中。When implemented in a class, the IDataObject methods allow the user to store data in multiple formats in an instance of the class. 以一種以上的格式儲存資料,可讓目標應用程式(也就是您不知道的格式需求)可以取出儲存的資料。Storing data in more than one format increases the chance that a target application, whose format requirements you might not know, can retrieve the stored data. 若要將資料儲存在的實例中 IDataObject ,請呼叫 SetData 方法,並在參數中指定資料格式 formatTo store data in an instance of IDataObject, call the SetData method and specify the data format in the format parameter. autoConvert false 如果您不想要在抓取儲存的資料時,將其轉換成另一種格式,請將參數設定為。Set the autoConvert parameter to false if you do not want stored data to be converted to another format when it is retrieved. SetData在的某個實例上多次叫 IDataObject 用,以一種以上的格式儲存資料。Invoke SetData multiple times on one instance of IDataObject to store data in more than one format.

您可以藉 IDataObject 由呼叫 GetData 方法並在參數中指定資料格式,從取出儲存的資料 formatYou retrieve stored data from an IDataObject by calling the GetData method and specifying the data format in the format parameter. autoConvert 參數設定為,以只抓取以 false 指定格式儲存的資料。Set the autoConvert parameter to false to retrieve only data that was stored in the specified format. 若要將儲存的資料轉換成指定的格式,請設定 autoConverttrue ,或不要使用 autoConvertTo convert the stored data to the specified format, set autoConvert to true, or do not use autoConvert.

若要判斷中儲存之資料的格式 IDataObject ,請使用下列 IDataObject 方法。To determine the formats of the data stored in an IDataObject, use the following IDataObject methods.

  • 呼叫 GetFormats 方法,以取得資料可供使用之所有格式的陣列。Call the GetFormats method to retrieve an array of all the formats in which the data is available. autoConvert 參數設定為, false 以只取得儲存資料的格式。Set the autoConvert parameter to false to get only the formats in which the data is stored. 若要取得資料可供使用的所有格式,請將設定 autoConverttrue ,或不使用此參數。To get all the formats in which the data is available, set autoConvert to true, or do not use this parameter.

  • 呼叫 GetDataPresent 方法,以判斷儲存的資料是否可用於特定的格式。Call the GetDataPresent method to determine whether stored data is available in a certain format. 如果您不想要將儲存的資料轉換成指定的格式,請將 autoConvert 參數設定為 falseIf you do not want stored data to be converted to the specified format, set the autoConvert parameter to false.

請參閱 DataObject 類別以取得此介面的實作為。See the DataObject class for an implementation of this interface. 如需 DataFormats 預先定義的資料格式,請參閱類別 ClipboardSee the DataFormats class for the predefined Clipboard data formats.

方法

GetData(String)

擷取與指定資料格式產生關聯的資料。Retrieves the data associated with the specified data format.

GetData(String, Boolean)

擷取與指定的資料格式相關的資料,使用布林值來決定是否要將資料轉換成格式。Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetData(Type)

擷取與指定的類別型別格式相關的資料。Retrieves the data associated with the specified class type format.

GetDataPresent(String)

決定儲存於這個執行個體中的資料是否與指定的格式相關,或是可以轉換成指定的格式。Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetDataPresent(String, Boolean)

決定儲存於這個執行個體中的資料是否與指定的格式相關,使用布林值來決定是否要將資料轉換成格式。Determines whether data stored in this instance is associated with the specified format, using a Boolean value to determine whether to convert the data to the format.

GetDataPresent(Type)

決定儲存於這個執行個體中的資料是否與指定的格式相關,或是可以轉換成指定的格式。Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetFormats()

傳回與儲存於這個執行個體中的資料相關的,或者可以轉換的所有格式的清單。Returns a list of all formats that data stored in this instance is associated with or can be converted to.

GetFormats(Boolean)

取得與儲存於這個執行個體中的資料相關的,或者可以轉換的所有格式清單,使用布林值來決定要擷取資料可以轉換的所有格式,還是只要擷取原生的資料格式。Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.

SetData(Object)

使用格式的資料類別,將指定的資料儲存於這個執行個體中。Stores the specified data in this instance, using the class of the data for the format.

SetData(String, Boolean, Object)

將指定的資料和其相關的格式儲存於這個執行個體中,使用布林值指定是否可以將資料轉換成另一種格式。Stores the specified data and its associated format in this instance, using a Boolean value to specify whether the data can be converted to another format.

SetData(String, Object)

將指定的資料和其相關的格式儲存於這個執行個體中。Stores the specified data and its associated format in this instance.

SetData(Type, Object)

將指定的資料和其相關的類別型別儲存在這個執行個體中。Stores the specified data and its associated class type in this instance.

適用於

另請參閱