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<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 安全性

请参见

参考

ClipboardObject 类

Microsoft.VisualStudio.Data.Framework 命名空间