Clipboard.GetText Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft Textdaten aus der Zwischenablage ab.

Überlädt

GetText()	Ruft Textdaten im Text-Format oder im UnicodeText-Format aus der Zwischenablage ab, je nach Betriebssystem.
GetText(TextDataFormat)	Ruft Textdaten im vom angegebenen TextDataFormat-Wert definierten Format aus der Zwischenablage ab.

GetText()

Ruft Textdaten im Text-Format oder im UnicodeText-Format aus der Zwischenablage ab, je nach Betriebssystem.

public:
 static System::String ^ GetText();

public static string GetText ();

static member GetText : unit -> string

Public Shared Function GetText () As String

Gibt zurück

String

Die Textdaten in der Zwischenablage oder Empty, wenn die Zwischenablage keine Daten im Text-Format oder im UnicodeText-Format enthält, je nach Betriebssystem.

Ausnahmen

ExternalException

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

ThreadStateException

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 GetText 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 gibt Textdaten im UnicodeText Format unter Windows XP Home Edition, Windows XP Professional, Windows Server 2003 und Windows 2000 zurück. Andernfalls gibt diese Methode Textdaten im Text Format zurück.

Verwenden Sie die ContainsText -Methode, um zu bestimmen, ob die Zwischenablage Textdaten enthält, bevor Sie sie mit dieser Methode abrufen.

Verwenden Sie die SetText -Methode, um der Zwischenablage Textdaten hinzuzufügen.

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

• TextDataFormat
• ContainsText
• SetText

GetText(TextDataFormat)

Ruft Textdaten im vom angegebenen TextDataFormat-Wert definierten Format aus der Zwischenablage ab.

public:
 static System::String ^ GetText(System::Windows::Forms::TextDataFormat format);

public static string GetText (System.Windows.Forms.TextDataFormat format);

static member GetText : System.Windows.Forms.TextDataFormat -> string

Public Shared Function GetText (format As TextDataFormat) As String

Parameter

format

TextDataFormat

Einer der TextDataFormat-Werte.

Gibt zurück

String

Die Textdaten in der Zwischenablage oder Empty, wenn die Zwischenablage keine Daten im angegebenen Format enthält.

Ausnahmen

ExternalException

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

ThreadStateException

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

InvalidEnumArgumentException

format ist kein gültiger TextDataFormat-Wert.

Beispiele

Im folgenden Beispiel wird dieser Member 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 die ContainsText -Methode, um zu bestimmen, ob die Zwischenablage Textdaten enthält, bevor Sie sie mit dieser Methode abrufen.

Verwenden Sie die SetText -Methode, um der Zwischenablage Textdaten hinzuzufügen.

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

• TextDataFormat
• ContainsText
• SetText