Clipboard.SetData(String, Object) 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

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

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，代表要加入的資料。

例外狀況

ExternalException

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

ThreadStateException

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

ArgumentNullException

data 為 null。

範例

下列範例示範此成員。

// 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 為 屬性。

另請參閱

• DataFormats
• ContainsData(String)
• GetData(String)