ClipboardObject.IDataObject.GetData 方法
從來源資料物件取得資料。 這個方法由資料消費者呼叫。 它會在指定的 FORMATETC 結構所描述的資料並將指定的 STGMEDIUM 結構傳輸這些資料。 接著再由呼叫端負責釋放 STGMEDIUM 結構。
命名空間： Microsoft.VisualStudio.Data.Framework
組件： Microsoft.VisualStudio.Data.Framework (在 Microsoft.VisualStudio.Data.Framework.dll 中)
語法
'宣告
Private Sub GetData ( _
pformatetcIn As FORMATETC(), _
pRemoteMedium As STGMEDIUM() _
) Implements IDataObject.GetData
void IDataObject.GetData(
FORMATETC[] pformatetcIn,
STGMEDIUM[] pRemoteMedium
)
private:
virtual void GetData(
array<FORMATETC>^ pformatetcIn,
array<STGMEDIUM>^ pRemoteMedium
) sealed = IDataObject::GetData
private abstract GetData :
pformatetcIn:FORMATETC[] *
pRemoteMedium:STGMEDIUM[] -> unit
private override GetData :
pformatetcIn:FORMATETC[] *
pRemoteMedium:STGMEDIUM[] -> unit
JScript 不支援明確介面實作。
參數
pformatetcIn
類型：array<FORMATETC[]in FORMATETC 結構的參考，以傳址方式傳遞的，定義格式、媒體和目標裝置使用，當傳遞資料時。 指定一個媒體，允許方法選取項目中的最佳媒體指定使用 Boolean 或運算子，是可能的。
pRemoteMedium
類型：array<STGMEDIUM[]這個方法傳回時，包含表示包含傳回之資料的存放媒體透過其 tymed 成員的 STGMEDIUM 結構的參考成員值釋放媒體的責任透過其 pUnkForRelease 成員的值。 如果 pUnkForRelease 為 nullnull 參考 (即 Visual Basic 中的 Nothing)，便由媒體的接收者負責釋放媒體；否則 pUnkForRelease 會指向適當物件上的 IUnknown 介面，以便呼叫其 Release 方法。 必須配置和這個方法填入媒體。 這個參數會以未初始化的狀態傳遞。
實作
IDataObject.GetData(FORMATETC, STGMEDIUM)
例外狀況
| 例外狀況 | 條件 |
|---|---|
| ArgumentNullException | Clipboard 物件不是包裝的 Microsoft.VisualStudio.OLE.Interop.IDataObject ，且 pformatetcIn 和 pRemoteMedium 參數為 nullnull 參考 (即 Visual Basic 中的 Nothing)。 |
| ArgumentException | Clipboard 物件不是包裝的 Microsoft.VisualStudio.OLE.Interop.IDataObject ，且 pformatetcIn 和 pRemoteMedium 結構的長度為零。 |
備註
如果剪貼簿物件包裝現有的 IDataObject (從 Microsoft.VisualStudio.OLE.Interop 命名空間)，這個方法委派給對應的 GetData 呼叫該命名空間。 否則，，以免 Clipboard 物件可以在現有的 IDataObject，它會嘗試呼叫轉譯為從 System.Runtime.InteropServices.ComTypes 命名空間的 GetData 。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。