ClipboardObject.IDataObject.GetDataHere 方法
從來源資料物件取得資料。 這個方法 (由資料消費者呼叫) 與 IDataObject.GetData 方法不同，呼叫端必須針對後者配置及釋放指定的存放媒體。
命名空間： Microsoft.VisualStudio.Data.Framework
組件： Microsoft.VisualStudio.Data.Framework (在 Microsoft.VisualStudio.Data.Framework.dll 中)
語法
'宣告
Private Sub GetDataHere ( _
pFormatetc As FORMATETC(), _
pRemoteMedium As STGMEDIUM() _
) Implements IDataObject.GetDataHere
void IDataObject.GetDataHere(
FORMATETC[] pFormatetc,
STGMEDIUM[] pRemoteMedium
)
private:
virtual void GetDataHere(
array<FORMATETC>^ pFormatetc,
array<STGMEDIUM>^ pRemoteMedium
) sealed = IDataObject::GetDataHere
private abstract GetDataHere :
pFormatetc:FORMATETC[] *
pRemoteMedium:STGMEDIUM[] -> unit
private override GetDataHere :
pFormatetc:FORMATETC[] *
pRemoteMedium:STGMEDIUM[] -> unit
JScript 不支援明確介面實作。
參數
pFormatetc
類型：array<FORMATETC[]in FORMATETC 結構的參考，以傳址方式傳遞的，定義格式、媒體和目標裝置使用，當傳遞資料時。 只能指定一個媒體。 tymed可指定，，而且只有下列 TYMED 值有效:TYMED_ISTORAGE、TYMED_ISTREAM、TYMED_HGLOBAL 和 TYMED_FILE。
pRemoteMedium
類型：array<STGMEDIUM[]以傳址方式傳遞的 STGMEDIUM，定義包含要傳輸之資料的存放媒體。 必須由呼叫端配置並由這個方法填入媒體。 呼叫端也必須釋放媒體。 這個方法的實作必須永遠提供 nullnull 參考 (即 Visual Basic 中的 Nothing) 的值給這個參數所指向之 T:Microsoft.VisualStudio.OLE.Interop.STGMEDIUM 結構的 [pUnkForRelease] 成員。
實作
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)
例外狀況
| 例外狀況 | 條件 |
|---|---|
| ArgumentNullException | Clipboard 物件不是包裝的 Microsoft.VisualStudio.OLE.Interop.IDataObject ，且 pFormatetc 和 pRemoteMedium 參數為 nullnull 參考 (即 Visual Basic 中的 Nothing)。 |
| ArgumentException | Clipboard 物件不是包裝的 Microsoft.VisualStudio.OLE.Interop.IDataObject ，且 pFormatetc 和 pRemoteMedium 結構的長度為零。 |
備註
如果剪貼簿物件包裝現有的 IDataObject (從 Microsoft.VisualStudio.OLE.Interop 命名空間)，這個方法委派給對應的 GetDataHere 呼叫該命名空間。 否則，，以免 Clipboard 物件可以在現有的 IDataObject，它會嘗試呼叫轉譯為從 System.Runtime.InteropServices.ComTypes 命名空間中的對應 GetDataHere 。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。