Clipboard.ContainsData(String) 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

Clipboard.cs

指出剪貼簿上是否有指定格式的資料，或是可以轉換為該格式的資料。

public:
 static bool ContainsData(System::String ^ format);

public static bool ContainsData (string? format);

static member ContainsData : string -> bool

Public Shared Function ContainsData (format As String) As Boolean

參數

format

String

要尋找的資料格式。 如需預先定義的格式，請參閱 DataFormats。

傳回

Boolean

如果剪貼簿上有指定 format 的資料，或是可轉換為該格式的資料，則為 true，否則為 false。

例外狀況

ExternalException

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

ThreadStateException

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

範例

下列範例示範這個成員。

// 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

備註

類別 DataFormats 包含預先定義的格式名稱，您可以搭配這個方法使用。

使用這個方法來判斷剪貼簿是否包含指定格式或相容格式的資料，然後再使用 GetData 方法擷取資料。

注意

如果資料儲存指定允許轉換，而且要求的格式與預存格式相容，則可以將資料轉換成另一種格式。 例如，儲存為 Unicode 的資料可以轉換成文字。

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

另請參閱

• DataFormats
• GetData(String)
• SetData(String, Object)