Clipboard.GetText Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera dane tekstowe ze Schowka.

Przeciążenia

GetText()	Pobiera dane tekstowe ze Schowka w formacie lub UnicodeText w Text zależności od systemu operacyjnego.
GetText(TextDataFormat)	Pobiera dane tekstowe ze Schowka w formacie wskazanym przez określoną TextDataFormat wartość.

GetText()

Pobiera dane tekstowe ze Schowka w formacie lub UnicodeText w Text zależności od systemu operacyjnego.

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

public static string GetText ();

static member GetText : unit -> string

Public Shared Function GetText () As String

Zwraca

String

Dane tekstowe Schowka lub Empty schowek nie zawierają danych w Text formacie lub UnicodeText w zależności od systemu operacyjnego.

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 .

Przykłady

W poniższym przykładzie pokazano przeciążenie GetText 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 zwraca 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 zwraca dane tekstowe w Text formacie.

ContainsText Użyj metody , aby określić, czy Schowek zawiera dane tekstowe przed pobraniem go za pomocą tej metody.

SetText Użyj metody , aby dodać dane tekstowe do Schowka.

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
• SetText

GetText(TextDataFormat)

Pobiera dane tekstowe ze Schowka w formacie wskazanym przez określoną TextDataFormat wartość.

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

Parametry

format

TextDataFormat

Jedna z TextDataFormat wartości.

Zwraca

String

Dane tekstowe Schowka lub Empty schowek nie zawierają danych w określonym formacie.

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 .

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

ContainsText Użyj metody , aby określić, czy Schowek zawiera dane tekstowe przed pobraniem go za pomocą tej metody.

SetText Użyj metody , aby dodać dane tekstowe do Schowka.

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
• SetText