Clipboard.ContainsData(String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
指出剪貼簿上是否有指定格式的資料,或是可以轉換為該格式的資料。
public:
static bool ContainsData(System::String ^ format);
public static bool ContainsData (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。
傳回
如果剪貼簿上有指定 format
的資料,或是可轉換為該格式的資料,則為 true
,否則為 false
。
例外狀況
無法清除剪貼簿。 這通常在剪貼簿由另一個處理序使用時發生。
目前執行緒 (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 屬性標示。
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應