从源数据对象中获取数据。 数据使用者调用的此方法与 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[]对 FORMATETC 结构的引用,通过引用传递,则定义格式、媒体和目标设备使用,传递数据时。 只有一个媒体在 tymed中指定,因此,只有以下 TYMED 值有效:TYMED_ISTORAGE、TYMED_ISTREAM、TYMED_HGLOBAL 和 TYMED_FILE。
pRemoteMedium
类型:array<STGMEDIUM[]由引用传递的 STGMEDIUM,它定义包含正在传输的数据的存储介质。 必须由调用方分配和此方法填充媒体。 调用方还必须释放介质。 此方法的实现必须始终为此参数指向的 T:Microsoft.VisualStudio.OLE.Interop.STGMEDIUM 结构的 [pUnkForRelease] 成员提供一个 nullnull 引用(在 Visual Basic 中为 Nothing) 值。
实现
IDataObject.GetDataHere(FORMATETC, 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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息,请参阅通过部分受信任的代码使用库。