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 textdaten in der Zwischenablage vorhanden sind.
Überlädt
| Name | Beschreibung |
|---|---|
| ContainsText() |
Gibt an, ob je nach Betriebssystem Daten in der Zwischenablage oder TextUnicodeText im Format vorhanden sind. |
| ContainsText(TextDataFormat) |
Gibt an, ob textdaten in der Zwischenablage im durch den angegebenen Wert angegebenen TextDataFormat Format vorhanden sind. |
ContainsText()
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
Gibt an, ob je nach Betriebssystem Daten in der Zwischenablage oder TextUnicodeText im Format vorhanden sind.
public:
static bool ContainsText();public static bool ContainsText();static member ContainsText : unit -> boolPublic Shared Function ContainsText () As BooleanGibt zurück
truewenn textdaten in der Zwischenablage vorhanden sind; andernfalls . false
Ausnahmen
Die Zwischenablage konnte nicht gelöscht werden. Dies tritt in der Regel auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.
Der aktuelle Thread befindet sich nicht im Sta-Modus (Single Threaded Apartment). Fügen Sie die STAThreadAttribute Methode Ihrer Anwendung Main 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 format UnicodeText auf Windows XP Home Edition, Windows XP Professional, Windows Server 2003 und Windows 2000. Andernfalls sucht diese Methode nach dem Vorhandensein von Daten im Text Format.
Verwenden Sie diese Methode, um zu bestimmen, ob die Zwischenablage Textdaten enthält, bevor Sie sie mit der GetText Methode abrufen.
Note
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 die Main-Methode mit dem STAThreadAttribute-Attribut markiert ist.
Weitere Informationen
Gilt für:
ContainsText(TextDataFormat)
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
- Quelle:
- Clipboard.cs
Gibt an, ob textdaten in der Zwischenablage im durch den angegebenen Wert angegebenen TextDataFormat Format vorhanden sind.
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
truewenn in der Zwischenablage Textdaten im für ; andernfalls formatangegebenen Wert vorhanden falsesind.
Ausnahmen
Die Zwischenablage konnte nicht gelöscht werden. Dies tritt in der Regel auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.
Der aktuelle Thread befindet sich nicht im Sta-Modus (Single Threaded Apartment). Fügen Sie die STAThreadAttribute Methode Ihrer Anwendung Main 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 bestimmen, ob die Zwischenablage Textdaten enthält, bevor Sie sie mit der GetText Methode abrufen.
Note
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 die Main-Methode mit dem STAThreadAttribute-Attribut markiert ist.
