ClipboardObject.IDataObject.SetData 方法

将数据传输至实现此方法的对象。 此方法由包含数据源的对象调用。

命名空间:  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
    类型:Int32

    true 指定调用的数据对象,该对象实现 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 安全性

请参阅

参考

ClipboardObject 类

Microsoft.VisualStudio.Data.Framework 命名空间