共用方式為


Clipboard.SetData(String, Object) 方法

定義

清除剪貼簿,然後加入指定之格式的資料。

public:
 static void SetData(System::String ^ format, System::Object ^ data);
public static void SetData (string format, object data);
static member SetData : string * obj -> unit
Public Shared Sub SetData (format As String, data As Object)

參數

format
String

要設定的資料格式。 如需預先定義的格式,請參閱 DataFormats

data
Object

Object,代表要加入的資料。

例外狀況

無法清除剪貼簿。 這通常在剪貼簿由另一個處理序使用時發生。

目前執行緒 (Thread) 不是在單一執行緒 Apartment (STA) 模式。 將 STAThreadAttribute 加入至應用程式的 Main 方法。

datanull

範例

下列範例示範此成員。

// Demonstrates SetData, ContainsData, and GetData.
public Object SwapClipboardFormattedData(String format, Object data)
{
    Object returnObject = null;
    if (Clipboard.ContainsData(format))
    {
        returnObject = Clipboard.GetData(format);
        Clipboard.SetData(format, data);
    }
    return returnObject;
}
' Demonstrates SetData, ContainsData, and GetData.
Public Function SwapClipboardFormattedData( _
    ByVal format As String, ByVal data As Object) As Object

    Dim returnObject As Object = Nothing

    If (Clipboard.ContainsData(format)) Then
        returnObject = Clipboard.GetData(format)
        Clipboard.SetData(format, data)
    End If

    Return returnObject

End Function

備註

如果您不知道目標應用程式的格式,您可以使用此方法以多種格式儲存資料。

使用此方法儲存的資料可以在擷取時轉換成相容的格式。

若要以特定格式從剪貼簿擷取資料,請先使用 ContainsData 方法來判斷剪貼簿是否包含該格式的資料,然後再使用 GetData 方法擷取資料。

注意

類別 Clipboard 只能在設定為單一線程 Apartment (STA) 模式的執行緒中使用。 若要使用這個類別,請確定您的 Main 方法已標示 STAThreadAttribute 為 屬性。

適用於

另請參閱