将数据传输至实现此方法的对象。此方法由包含数据源的对象调用。
命名空间: 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<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
由引用传递的 FORMATETC 结构,该结构定义数据对象在解释存储介质中包含的数据时所使用的格式。
- pmedium
类型:array<Microsoft.VisualStudio.OLE.Interop.STGMEDIUM[]
由引用传递的 STGMEDIUM 结构,该结构定义其中正在传递数据的存储介质。
- fRelease
类型:System.Int32
true 指定调用的数据对象,该对象实现 SetData,并在调用返回后拥有存储介质。这意味着,数据对象在使用介质后,必须调用 ReleaseStgMedium 函数来释放该介质。指定的false 调用方保留所有权存储媒介,并且,名为的数据对象仅调用期间使用存储媒介。
实现
IDataObject.SetData(array<FORMATETC[], array<STGMEDIUM[], Int32)
异常
异常 | 条件 |
---|---|
ArgumentNullException | 剪贴板对象不是包装的 Microsoft.VisualStudio.OLE.Interop.IDataObject,并 pFormatetc 和 pmedium 参数为null。 |
ArgumentException | 剪贴板对象不是包装的 Microsoft.VisualStudio.OLE.Interop.IDataObject,并 pFormatetc 和 pmedium 结构的长度为零。 |
备注
如果剪贴板对象包装现有 IDataObject (从 Microsoft.VisualStudio.OLE.Interop 命名空间),此方法委托传递给相应的 SetData 的调用来自该命名空间。否则,但是,如果剪贴板对象可以包装现有 IDataObject,它尝试将调用为从 System.Runtime.InteropServices.ComTypes 命名空间的相应 IDataObject.SetData。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。