Clipboard.SetText Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Czyści schowek, a następnie dodaje do niego dane tekstowe.

Przeciążenia

SetText(String)	Czyści schowek, a następnie dodaje dane tekstowe w Text formacie lub UnicodeText w zależności od systemu operacyjnego.
SetText(String, TextDataFormat)	Czyści schowek, a następnie dodaje dane tekstowe w formacie wskazanym przez określoną TextDataFormat wartość.

SetText(String)

Czyści schowek, a następnie dodaje dane tekstowe w Text formacie lub UnicodeText w zależności od systemu operacyjnego.

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)

Parametry

text

String

Tekst do dodania do Schowka.

Wyjątki

ExternalException

Nie można wyczyścić schowka. Zwykle występuje to, gdy schowek jest używany przez inny proces.

ThreadStateException

Bieżący wątek nie jest w trybie jednowątkowego mieszkania (STA). Dodaj metodę STAThreadAttribute do metody aplikacji Main .

ArgumentNullException

text jest lub nullEmpty.

Przykłady

W poniższym przykładzie pokazano przeciążenie SetText metody podobnej do tego przeciążenia.

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

Uwagi

Ta metoda dodaje dane tekstowe w UnicodeText formacie w systemie Windows XP Home Edition, Windows XP Professional, Windows Server 2003 i Windows 2000. W przeciwnym razie ta metoda dodaje dane tekstowe w Text formacie.

Aby pobrać dane tekstowe ze Schowka, najpierw użyj ContainsText metody , aby określić, czy Schowek zawiera dane tekstowe przed pobraniem GetText go za pomocą metody .

Uwaga

Klasa Clipboard może być używana tylko w wątkach ustawionych na tryb pojedynczego wątku (STA). Aby użyć tej klasy, upewnij się, że Main metoda jest oznaczona atrybutem STAThreadAttribute .

Zobacz też

• TextDataFormat
• ContainsText
• GetText

SetText(String, TextDataFormat)

Czyści schowek, a następnie dodaje dane tekstowe w formacie wskazanym przez określoną TextDataFormat wartość.

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)

Parametry

text

String

Tekst do dodania do Schowka.

format

TextDataFormat

Jedna z TextDataFormat wartości.

Wyjątki

ExternalException

Nie można wyczyścić schowka. Zwykle występuje to, gdy schowek jest używany przez inny proces.

ThreadStateException

Bieżący wątek nie jest w trybie jednowątkowego mieszkania (STA). Dodaj metodę STAThreadAttribute do metody aplikacji Main .

ArgumentNullException

text jest lub nullEmpty.

InvalidEnumArgumentException

format jest nieprawidłową TextDataFormat wartością.

Przykłady

W poniższym przykładzie pokazano ten element członkowski.

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

Uwagi

Aby pobrać dane tekstowe ze Schowka, najpierw użyj ContainsText metody , aby określić, czy Schowek zawiera dane tekstowe przed pobraniem GetText go za pomocą metody .

Uwaga

Klasa Clipboard może być używana tylko w wątkach ustawionych na tryb pojedynczego wątku (STA). Aby użyć tej klasy, upewnij się, że Main metoda jest oznaczona atrybutem STAThreadAttribute .

Zobacz też

• TextDataFormat
• ContainsText
• GetText