Clipboard.ContainsData(String) 方法

定义

命名空间:

System.Windows

程序集:

PresentationCore.dll

查询剪贴板上是否存在指定数据格式的数据。

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

如果剪贴板上有指定格式的数据，则为 true，否则为 false。

例外

ArgumentNullException

format 为 null。

示例

以下示例演示如何使用此方法。

// After this line executes, IsHTMLDataOnClipboard will be true if
// HTML data is available natively on the clipboard; if not, it 
// will be false.
bool IsHTMLDataOnClipboard = Clipboard.ContainsData(DataFormats.Html);

// If there is HTML data on the clipboard, retrieve it.
string htmlData;
if(IsHTMLDataOnClipboard)
{

    htmlData = Clipboard.GetText(TextDataFormat.Html);
}

' After this line executes, IsHTMLDataOnClipboard will be true if
' HTML data is available natively on the clipboard; if not, it 
' will be false.
Dim IsHTMLDataOnClipboard As Boolean = Clipboard.ContainsData(DataFormats.Html)

' If there is HTML data on the clipboard, retrieve it.
Dim htmlData As String
If IsHTMLDataOnClipboard Then

    htmlData = Clipboard.GetText(TextDataFormat.Html)

End If

注解

如果数据可以自动转换为指定的数据格式BitmapFileDrop，则或 将返回true数据格式的查询。 对于其他数据格式，仅当指定格式在剪贴板上本机可用时，此方法才返回 true 。

另请参阅

• ContainsAudio()
• ContainsFileDropList()
• ContainsImage()
• ContainsText
• GetData(String)
• SetData(String, Object)
• DataFormats