Clipboard.GetText Methode

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Hiermee worden tekstgegevens opgehaald van het Klembord.

Overloads

Name Description
GetText()

Hiermee worden tekstgegevens opgehaald van het Klembord in de Text of UnicodeText indeling, afhankelijk van het besturingssysteem.
GetText(TextDataFormat)

Hiermee worden tekstgegevens opgehaald van het Klembord in de indeling die wordt aangegeven door de opgegeven TextDataFormat waarde.

GetText()

Hiermee worden tekstgegevens opgehaald van het Klembord in de Text of UnicodeText indeling, afhankelijk van het besturingssysteem.

public:
 static System::String ^ GetText();
public static string GetText();
static member GetText : unit -> string
Public Shared Function GetText () As String

Retouren

String

De tekstgegevens van het Klembord of Empty als het Klembord geen gegevens in de Text of UnicodeText indeling bevat, afhankelijk van het besturingssysteem.

Uitzonderingen

ExternalException

Het Klembord kan niet worden gewist. Dit gebeurt meestal wanneer het Klembord wordt gebruikt door een ander proces.

ThreadStateException

De huidige thread bevindt zich niet in sta-modus (single threaded apartment). Voeg de STAThreadAttribute methode van Main uw toepassing toe.

Voorbeelden

In het volgende voorbeeld ziet u een overbelasting van de GetText methode die vergelijkbaar is met deze overbelasting.

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

Opmerkingen

Deze methode retourneert tekstgegevens in de indeling UnicodeText op Windows XP Home Edition, Windows XP Professional, Windows Server 2003 en Windows 2000. Anders retourneert deze methode tekstgegevens in de Text indeling.

Gebruik de ContainsText methode om te bepalen of het Klembord tekstgegevens bevat voordat u deze met deze methode opvraagt.

Gebruik de SetText methode om tekstgegevens toe te voegen aan het Klembord.

Note

De Clipboard klasse kan alleen worden gebruikt in threads die zijn ingesteld op de STA-modus (Single Thread Apartment). Als u deze klasse wilt gebruiken, moet u ervoor zorgen dat uw Main methode is gemarkeerd met het kenmerk STAThreadAttribute.

Zie ook

Van toepassing op

GetText(TextDataFormat)

Hiermee worden tekstgegevens opgehaald van het Klembord in de indeling die wordt aangegeven door de opgegeven TextDataFormat waarde.

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

Parameters

format
TextDataFormat

Een van de TextDataFormat waarden.

Retouren

String

De tekstgegevens van het Klembord of Empty als het Klembord geen gegevens in de opgegeven indeling bevat.

Uitzonderingen

ExternalException

Het Klembord kan niet worden gewist. Dit gebeurt meestal wanneer het Klembord wordt gebruikt door een ander proces.

ThreadStateException

De huidige thread bevindt zich niet in sta-modus (single threaded apartment). Voeg de STAThreadAttribute methode van Main uw toepassing toe.

InvalidEnumArgumentException

format is geen geldige TextDataFormat waarde.

Voorbeelden

In het volgende voorbeeld ziet u dit lid.

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

Opmerkingen

Gebruik de ContainsText methode om te bepalen of het Klembord tekstgegevens bevat voordat u deze met deze methode opvraagt.

Gebruik de SetText methode om tekstgegevens toe te voegen aan het Klembord.

Note

De Clipboard klasse kan alleen worden gebruikt in threads die zijn ingesteld op de STA-modus (Single Thread Apartment). Als u deze klasse wilt gebruiken, moet u ervoor zorgen dat uw Main methode is gemarkeerd met het kenmerk STAThreadAttribute.

Zie ook

Van toepassing op