将数据传输至实现此方法的对象。 此方法由包含数据源的对象调用。
命名空间: Microsoft.VisualStudio.Data.Framework
程序集: Microsoft.VisualStudio.Data.Framework(在 Microsoft.VisualStudio.Data.Framework.dll 中)
语法
声明
Private Sub SetData ( _
pFormatetc As FORMATETC(), _
pmedium As STGMEDIUM(), _
fRelease As Integer _
) Implements IDataObject.SetData
void IDataObject.SetData(
FORMATETC[] pFormatetc,
STGMEDIUM[] pmedium,
int fRelease
)
private:
virtual void SetData(
array<FORMATETC>^ pFormatetc,
array<STGMEDIUM>^ pmedium,
int fRelease
) sealed = IDataObject::SetData
private abstract SetData :
pFormatetc:FORMATETC[] *
pmedium:STGMEDIUM[] *
fRelease:int -> unit
private override SetData :
pFormatetc:FORMATETC[] *
pmedium:STGMEDIUM[] *
fRelease:int -> unit
JScript 不支持显式接口实现。
参数
pFormatetc
类型:array<FORMATETC[]FORMATETC 结构,如何传递引用,定义数据格式由对象使用了,则说明存储介质中包含的数据。
pmedium
类型:array<STGMEDIUM[]由引用传递的 STGMEDIUM 结构,该结构定义其中正在传递数据的存储介质。
fRelease
类型:Int32true 指定调用的数据对象,该对象实现 SetData,并在调用返回后拥有存储介质。 这意味着,数据对象在使用介质后,必须调用 ReleaseStgMedium 函数来释放该介质。 指定 的false 调用方保留存储媒介的所有权,并且,所调用的数据对象使用存储介质存储仅在调用的持续时间。
实现
IDataObject.SetData(FORMATETC, STGMEDIUM, Int32)
异常
异常 | 条件 |
---|---|
ArgumentNullException | 剪贴板对象不是包装的 Microsoft.VisualStudio.OLE.Interop.IDataObject,pFormatetc 和 pmedium 参数为空。 |
ArgumentException | 剪贴板对象不是包装的 Microsoft.VisualStudio.OLE.Interop.IDataObject,pFormatetc 和 pmedium 结构的长度为零。 |
备注
如果剪贴板对象包装现有的 IDataObject (从 Microsoft.VisualStudio.OLE.Interop 命名空间),此方法将调用委托给对应的 SetData 调用该命名空间。 否则,如果剪贴板,对象可能本身来包装现有 IDataObject,它尝试将对来自 System.Runtime.InteropServices.ComTypes 命名空间对应的 IDataObject.SetData。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息,请参阅通过部分受信任的代码使用库。