Clipboard.ContainsText 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

指示剪贴板上是否存在文本数据。

重载

名称	说明
ContainsText()	指示剪贴板 Text 上是否存在数据， UnicodeText 具体取决于操作系统。
ContainsText(TextDataFormat)	指示剪贴板上是否存在由指定 TextDataFormat 值指示的格式的文本数据。

ContainsText()

Source:

Clipboard.cs

指示剪贴板 Text 上是否存在数据， UnicodeText 具体取决于操作系统。

public:
 static bool ContainsText();

public static bool ContainsText();

static member ContainsText : unit -> bool

Public Shared Function ContainsText () As Boolean

返回

Boolean

true 如果剪贴板上有文本数据，则为否则，为 false.

例外

ExternalException

无法清除剪贴板。 当剪贴板被另一个进程使用时，通常会发生这种情况。

ThreadStateException

当前线程不在单线程单元（STA）模式下。 将它 STAThreadAttribute 添加到应用程序 Main 的方法。

示例

以下示例演示与此重载类似的方法的 ContainsText 重载。

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

注解

此方法检查 Windows XP Home Edition、Windows XP Professional、Windows Server 2003 和 Windows 2000 上UnicodeText格式的数据是否存在。 否则，此方法将检查是否存在采用格式的数据 Text 。

使用此方法确定剪贴板是否包含文本数据，然后再使用 GetText 该方法检索它。

注释

Clipboard 类只能在设置为单线程单元 (STA) 模式的线程中使用。 若要使用此类，请确保使用 Main 特性标记 STAThreadAttribute 方法。

另请参阅

• TextDataFormat
• Text
• UnicodeText
• GetText
• SetText

ContainsText(TextDataFormat)

Source:

Clipboard.cs

指示剪贴板上是否存在由指定 TextDataFormat 值指示的格式的文本数据。

public:
 static bool ContainsText(System::Windows::Forms::TextDataFormat format);

public static bool ContainsText(System.Windows.Forms.TextDataFormat format);

static member ContainsText : System.Windows.Forms.TextDataFormat -> bool

Public Shared Function ContainsText (format As TextDataFormat) As Boolean

参数

format

TextDataFormat

其中一个 TextDataFormat 值。

返回

Boolean

如果剪贴板上的文本数据位于指定的 值中，则为 ;否则为 < a0 />。

例外

ExternalException

无法清除剪贴板。 当剪贴板被另一个进程使用时，通常会发生这种情况。

ThreadStateException

当前线程不在单线程单元（STA）模式下。 将它 STAThreadAttribute 添加到应用程序 Main 的方法。

InvalidEnumArgumentException

format 不是有效 TextDataFormat 值。

示例

以下示例演示此成员。

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

注解

使用此方法确定剪贴板是否包含文本数据，然后再使用 GetText 该方法检索它。

注释

Clipboard 类只能在设置为单线程单元 (STA) 模式的线程中使用。 若要使用此类，请确保使用 Main 特性标记 STAThreadAttribute 方法。

另请参阅

• TextDataFormat
• GetText
• SetText