Clipboard.ContainsText Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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()
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
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 -> boolPublic Shared Function ContainsText () As BooleanGibt 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)
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
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 -> boolPublic Shared Function ContainsText (format As TextDataFormat) As BooleanParameter
- 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.
