IDataObject 介面

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

IDataObject.cs

提供一種格式無關的資料傳輸機制。

public interface class IDataObject

public interface IDataObject

type IDataObject = interface

Public Interface IDataObject

衍生

System.Windows.Forms.DataObject

System.Windows.Forms.ITypedDataObject

備註

該 IDataObject 介面由類別使用 Clipboard ，並用於拖放操作。

當實作在類別中時，這些 IDataObject 方法允許使用者以多種格式在類別的實例中儲存資料。 以多種格式儲存資料，會增加目標應用程式（你可能不知道其格式要求）取得這些儲存資料的機會。 若要將資料儲存在 的 IDataObject實例中， SetData 呼叫方法並在參數中 format 指定資料格式。 如果不希望儲存的資料在取回時被轉換成其他格式，請設定 autoConvert 參數 false 為 在同一 SetData 實例 IDataObject 中多次呼叫，以儲存多種格式的資料。

你可以透過呼叫IDataObject方法並在參數中GetData指定資料格式來取得儲存的資料format。 將參數設 autoConvert 為 false 只取得以指定格式儲存的資料。 若要將儲存的資料轉換為指定格式，請設定 autoConvert 為 true，或不使用 autoConvert。

要確定儲存在 中的 IDataObject資料格式，請使用以下 IDataObject 方法。

• 呼叫 GetFormats 該方法，取得包含所有資料可用格式的陣列。 將參數設 autoConvert 為 只 false 取得資料所儲存格式。 要取得所有資料可用格式，請將 設 autoConvert 為 true，或不使用此參數。

• 呼叫該 GetDataPresent 方法以判斷儲存的資料是否以特定格式存在。 如果你不希望儲存的資料轉換成指定格式，請將參數設 autoConvert 為 false。

請參閱該 DataObject 類別以了解此介面的實作。 請參閱類別 DataFormats 以了解預先定義 Clipboard 的資料格式。

方法

名稱	Description
GetData(String, Boolean)	擷取與指定資料格式相關的資料，並使用布林運算來判斷是否要將資料轉換成該格式。
GetData(String)	擷取與指定資料格式相關的資料。
GetData(Type)	擷取與指定類別類型格式相關的資料。
GetDataPresent(String, Boolean)	判斷此實例中儲存的資料是否與指定格式相關聯，並使用布林值決定是否將資料轉換為該格式。
GetDataPresent(String)	判斷此實例中儲存的資料是否與指定格式相關聯，或可轉換為該格式。
GetDataPresent(Type)	判斷此實例中儲存的資料是否與指定格式相關聯，或可轉換為該格式。
GetFormats()	回傳所有本實例資料所關聯或可轉換成格式的清單。
GetFormats(Boolean)	取得本實例中資料所關聯或可轉換成的所有格式清單，並使用布林值判斷是否要擷取所有可轉換格式或僅取原生資料格式。
SetData(Object)	在此實例中儲存指定資料，並使用資料的類別作為格式。
SetData(String, Boolean, Object)	在此實例中儲存指定的資料及其相關格式，並使用布林值來指定資料是否能轉換成其他格式。
SetData(String, Object)	在此實例中儲存指定的資料及其相關格式。
SetData(Type, Object)	在此實例中儲存指定的資料及其相關類別類型。

擴充方法

名稱	Description
TryGetData<T>(IDataObject, String, Boolean, T)	提供一種格式無關的資料傳輸機制。
TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T)	提供一種格式無關的資料傳輸機制。
TryGetData<T>(IDataObject, String, T)	提供一種格式無關的資料傳輸機制。
TryGetData<T>(IDataObject, T)	提供一種格式無關的資料傳輸機制。

另請參閱

• DataObject
• DataFormats