Clipboard.SetText Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Löscht die Zwischenablage und fügt ihm dann Textdaten hinzu.

Überlädt

SetText(String)	Löscht die Zwischenablage und fügt dann im Text-Format oder UnicodeText-Format Textdaten hinzu, je nach Betriebssystem.
SetText(String, TextDataFormat)	Löscht die Zwischenablage und fügt dann Textdaten im Format hinzu, das vom angegebenen TextDataFormat-Wert definiert wird.

SetText(String)

Löscht die Zwischenablage und fügt dann im Text-Format oder UnicodeText-Format Textdaten hinzu, je nach Betriebssystem.

public:
 static void SetText(System::String ^ text);

public static void SetText (string text);

static member SetText : string -> unit

Public Shared Sub SetText (text As String)

Parameter

text

String

Der Text, der der Zwischenablage hinzugefügt werden soll.

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.

ArgumentNullException

text ist null oder Empty.

Beispiele

Im folgenden Beispiel wird eine Überladung der Methode veranschaulicht, die SetText 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 fügt Textdaten im UnicodeText Format unter Windows XP Home Edition, Windows XP Professional, Windows Server 2003 und Windows 2000 hinzu. Andernfalls fügt diese Methode Textdaten im Text Format hinzu.

Um Textdaten aus der Zwischenablage abzurufen, verwenden Sie zunächst die ContainsText -Methode, um zu bestimmen, 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

• TextDataFormat
• ContainsText
• GetText

SetText(String, TextDataFormat)

Löscht die Zwischenablage und fügt dann Textdaten im Format hinzu, das vom angegebenen TextDataFormat-Wert definiert wird.

public:
 static void SetText(System::String ^ text, System::Windows::Forms::TextDataFormat format);

public static void SetText (string text, System.Windows.Forms.TextDataFormat format);

static member SetText : string * System.Windows.Forms.TextDataFormat -> unit

Public Shared Sub SetText (text As String, format As TextDataFormat)

Parameter

text

String

Der Text, der der Zwischenablage hinzugefügt werden soll.

format

TextDataFormat

Einer der TextDataFormat-Werte.

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.

ArgumentNullException

text ist null oder Empty.

InvalidEnumArgumentException

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

Um Textdaten aus der Zwischenablage abzurufen, verwenden Sie zunächst die ContainsText -Methode, um zu bestimmen, 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

• TextDataFormat
• ContainsText
• GetText