DataObject.IDataObject.GetData(FORMATETC, STGMEDIUM) 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

從來源資料物件取得資料。 GetData(FORMATETC, STGMEDIUM) 方法由資料消費者 (Data Consumer) 呼叫，以呈現指定的 FORMATETC 結構所描述的資料，並透過指定的 STGMEDIUM 結構傳輸這些資料。 接著再由呼叫端負責釋放 STGMEDIUM 結構。

 virtual void System.Runtime.InteropServices.ComTypes.IDataObject.GetData(System::Runtime::InteropServices::ComTypes::FORMATETC % formatetc, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::STGMEDIUM % medium) = System::Runtime::InteropServices::ComTypes::IDataObject::GetData;

void IDataObject.GetData (ref System.Runtime.InteropServices.ComTypes.FORMATETC formatetc, out System.Runtime.InteropServices.ComTypes.STGMEDIUM medium);

abstract member System.Runtime.InteropServices.ComTypes.IDataObject.GetData : FORMATETC * STGMEDIUM -> unit
override this.System.Runtime.InteropServices.ComTypes.IDataObject.GetData : FORMATETC * STGMEDIUM -> unit

Sub GetData (ByRef formatetc As FORMATETC, ByRef medium As STGMEDIUM) Implements IDataObject.GetData

參數

formatetc

FORMATETC

以傳址方式傳遞的 FORMATETC 結構的指標，定義傳遞資料時所要使用的格式、媒體和目標裝置。 您可以使用布林值 OR 運算子指定多個媒體，好讓方法可以在指定的媒體中選擇最適合的媒體。

medium

STGMEDIUM

當這個方法傳回時，會包含 STGMEDIUM 方法的指標，指出包含透過其 tymed 成員傳回資料的存放媒體，以及透過其 pUnkForRelease 成員值釋放媒體的責任。 如果 pUnkForRelease 為 null，便由媒體的接收者負責釋放媒體；否則 pUnkForRelease 會指向適當物件上的 IUnknown 介面，以便呼叫其 Release 方法。 媒體必須由 GetData(FORMATETC, STGMEDIUM) 配置及填入。 這個參數會以未初始化的狀態傳遞。

實作

GetData(FORMATETC, STGMEDIUM)

例外狀況

OutOfMemoryException

沒有足夠記憶體可以執行這項作業。

備註

這個成員是明確介面成員實作， 它只有在 DataObject 轉型成 IDataObject 介面時才能使用。