共用方式為

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

Clipboard 物件不是包裝的 Microsoft.VisualStudio.OLE.Interop.IDataObject ，且 pFormatetc 和 pmedium 參數為 null。
ArgumentException

Clipboard 物件不是包裝的 Microsoft.VisualStudio.OLE.Interop.IDataObject ，且 pFormatetc 和 pmedium 結構的長度為零。

備註

如果剪貼簿物件包裝現有的 IDataObject (從 Microsoft.VisualStudio.OLE.Interop 命名空間)，這個方法委派給對應的 SetData 呼叫該命名空間。 否則，，以免 Clipboard 物件可以在現有的 IDataObject，它會嘗試呼叫轉譯為從 System.Runtime.InteropServices.ComTypes 命名空間中的對應 IDataObject.SetData 。

.NET Framework 安全性

請參閱

參考

ClipboardObject 類別

Microsoft.VisualStudio.Data.Framework 命名空間