从源数据对象中获取数据。 此方法将由数据使用者调用。 在指定的 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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息,请参阅通过部分受信任的代码使用库。