从源数据对象中获取数据。数据使用者调用的此方法与 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<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
为 FORMATETC 结构的引用,通过引用,定义布局,中等和目标设备使用,传递数据时。仅中等在 tymed可以指定,因此,只有以下 TYMED 值有效:TYMED_ISTORAGE、TYMED_ISTREAM、TYMED_HGLOBAL和TYMED_FILE。
- pRemoteMedium
类型:array<Microsoft.VisualStudio.OLE.Interop.STGMEDIUM[]
由引用传递的 STGMEDIUM,它定义包含正在传输的数据的存储介质。必须由调用方分配以及方法来填充媒体。调用方还必须释放介质。此方法的实现必须始终为此参数指向的 T:Microsoft.VisualStudio.OLE.Interop.STGMEDIUM 结构的 [pUnkForRelease] 成员提供一个 nullnull 引用(在 Visual Basic 中为 Nothing) 值。
实现
IDataObject.GetDataHere(array<FORMATETC[], array<STGMEDIUM[])
异常
异常 | 条件 |
---|---|
ArgumentNullException | 剪贴板对象不是包装的 Microsoft.VisualStudio.OLE.Interop.IDataObject,并 pFormatetc 和 pRemoteMedium 参数是 nullnull 引用(在 Visual Basic 中为 Nothing)。 |
ArgumentException | 剪贴板对象不是包装的 Microsoft.VisualStudio.OLE.Interop.IDataObject,并 pFormatetc 和 pRemoteMedium 结构的长度为零。 |
备注
如果剪贴板对象包装现有 IDataObject (从 Microsoft.VisualStudio.OLE.Interop 命名空间),此方法委托传递给相应的 GetDataHere 的调用来自该命名空间。否则,但是,如果剪贴板对象可以包装现有 IDataObject,它尝试将调用为从 System.Runtime.InteropServices.ComTypes 命名空间的相应 GetDataHere。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。