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[]

    FORMATETC 结构的引用,通过引用传递,则定义格式、媒体和目标设备使用,传递数据时。 指定多一个媒体,允许方法选择打印机中的最佳指定媒体的。Boolean 使用或运算符,也是可能的。

  • pRemoteMedium
    类型:array<STGMEDIUM[]

    当此方法返回时,通过值指示包含它的 pUnkForRelease 成员包含对返回的数据存储媒介通过其 tymed 成员的 STGMEDIUM 结构的引用和释放负责的媒体。 如果 pUnkForRelease 为 nullnull 引用(在 Visual Basic 中为 Nothing),则介质接收方负责释放介质;否则,pUnkForRelease 指向相应对象上的 IUnknown 接口,以便调用其 Release 方法。 必须分配和此方法填充媒体。 该参数未经初始化即被传递。

实现

IDataObject.GetData(FORMATETC, STGMEDIUM)

异常

异常 条件
ArgumentNullException

剪贴板对象不是包装的 Microsoft.VisualStudio.OLE.Interop.IDataObject,pformatetcIn 和 pRemoteMedium 参数为 nullnull 引用(在 Visual Basic 中为 Nothing)。

ArgumentException

剪贴板对象不是包装的 Microsoft.VisualStudio.OLE.Interop.IDataObject,pformatetcIn 和 pRemoteMedium 结构的长度为零。

备注

如果剪贴板对象包装现有的 IDataObject (从 Microsoft.VisualStudio.OLE.Interop 命名空间),此方法将调用委托给对应的 GetData 调用该命名空间。 否则,如果剪贴板,对象可能本身来包装现有 IDataObject,它尝试将对来自 System.Runtime.InteropServices.ComTypes 命名空间的 GetData

.NET Framework 安全性

请参阅

参考

ClipboardObject 类

Microsoft.VisualStudio.Data.Framework 命名空间