Freigeben über


Clipboard.ContainsText Methode

Definition

Gibt an, ob die Zwischenablage Textdaten enthält.

Überlädt

ContainsText()

Gibt an, ob die Zwischenablage Daten im Text-Format oder UnicodeText-Format enthält, je nach Betriebssystem.

ContainsText(TextDataFormat)

Gibt an, ob die Zwischenablage Textdaten im vom angegebenen TextDataFormat-Wert definierten Format enthält.

ContainsText()

Gibt an, ob die Zwischenablage Daten im Text-Format oder UnicodeText-Format enthält, je nach Betriebssystem.

public:
 static bool ContainsText();
public static bool ContainsText ();
static member ContainsText : unit -> bool
Public Shared Function ContainsText () As Boolean

Gibt zurück

true, wenn Textdaten in der Zwischenablage gespeichert sind, andernfalls false.

Ausnahmen

Die Zwischenablage konnte nicht gelöscht werden. Dies tritt i. d. R. auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.

Der aktuelle Thread befindet sich nicht im STA-Modus (Singlethread-Apartment). Fügen Sie der Main-Methode der Anwendung das STAThreadAttribute hinzu.

Beispiele

Im folgenden Beispiel wird eine Überladung der Methode veranschaulicht, die ContainsText dieser Überladung ähnelt.

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

Hinweise

Diese Methode überprüft das Vorhandensein von Daten im UnicodeText Format unter Windows XP Home Edition, Windows XP Professional, Windows Server 2003 und Windows 2000. Andernfalls überprüft diese Methode, ob Daten im Text Format vorhanden sind.

Verwenden Sie diese Methode, um zu ermitteln, ob die Zwischenablage Textdaten enthält, bevor Sie sie mit der GetText -Methode abrufen.

Hinweis

Die Clipboard-Klasse kann nur in Threads verwendet werden, die auf den STA-Modus (Single Thread Apartment) festgelegt sind. Um diese Klasse zu verwenden, stellen Sie sicher, dass Ihre Main-Methode mit dem STAThreadAttribute-Attribut gekennzeichnet ist.

Weitere Informationen

Gilt für:

ContainsText(TextDataFormat)

Gibt an, ob die Zwischenablage Textdaten im vom angegebenen TextDataFormat-Wert definierten Format enthält.

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

Parameter

format
TextDataFormat

Einer der TextDataFormat-Werte.

Gibt zurück

true, wenn in der Zwischenablage Textdaten mit dem für format angegebenen Wert vorhanden sind, andernfalls false.

Ausnahmen

Die Zwischenablage konnte nicht gelöscht werden. Dies tritt i. d. R. auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.

Der aktuelle Thread befindet sich nicht im STA-Modus (Singlethread-Apartment). Fügen Sie der Main-Methode der Anwendung das STAThreadAttribute hinzu.

format ist kein gültiger TextDataFormat-Wert.

Beispiele

Im folgenden Beispiel wird dieses Element veranschaulicht.

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

Hinweise

Verwenden Sie diese Methode, um zu ermitteln, ob die Zwischenablage Textdaten enthält, bevor Sie sie mit der GetText -Methode abrufen.

Hinweis

Die Clipboard-Klasse kann nur in Threads verwendet werden, die auf den STA-Modus (Single Thread Apartment) festgelegt sind. Um diese Klasse zu verwenden, stellen Sie sicher, dass Ihre Main-Methode mit dem STAThreadAttribute-Attribut gekennzeichnet ist.

Weitere Informationen

Gilt für: