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 -> boolPublic Shared Function ContainsData (format As String) As Boolean参数
- format
- String
要查找的数据的格式。 请参阅 DataFormats 预定义格式。
返回
true 如果剪贴板上存在指定 format 或可转换为该格式的数据，则为 ;否则为 false。
例外
无法清除剪贴板。 当剪贴板被另一个进程使用时，通常会发生这种情况。
当前线程不在单线程单元（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 类只能在设置为单线程单元 (STA) 模式的线程中使用。 若要使用此类，请确保使用 Main 特性标记 STAThreadAttribute 方法。
