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 用，以多個格式儲存資料。

您可以從 擷取儲存的資料 IDataObject ，方法是呼叫 GetData 方法，並在 參數中 format 指定資料格式。 將 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