Clipboard.GetData(String) Methode

Definitie

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

Hiermee worden gegevens opgehaald van het Klembord in de opgegeven indeling.

public:
 static System::Object ^ GetData(System::String ^ format);
public static object GetData(string format);
static member GetData : string -> obj
Public Shared Function GetData (format As String) As Object

Parameters

format
String

De indeling van de gegevens die moeten worden opgehaald. Zie DataFormats voor vooraf gedefinieerde indelingen.

Retouren

Object

Een Object weergave van de Klembord-gegevens of null als het Klembord geen gegevens bevat die in de opgegeven format indeling staan of naar die indeling kunnen worden geconverteerd.

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 dit lid.

// Demonstrates SetData, ContainsData, and GetData.
public Object SwapClipboardFormattedData(String format, Object data)
{
    Object returnObject = null;
    if (Clipboard.ContainsData(format))
    {
        returnObject = Clipboard.GetData(format);
        Clipboard.SetData(format, data);
    }
    return returnObject;
}

' Demonstrates SetData, ContainsData, and GetData.
Public Function SwapClipboardFormattedData( _
    ByVal format As String, ByVal data As Object) As Object

    Dim returnObject As Object = Nothing

    If (Clipboard.ContainsData(format)) Then
        returnObject = Clipboard.GetData(format)
        Clipboard.SetData(format, data)
    End If

    Return returnObject

End Function

Opmerkingen

Gebruik de ContainsData methode om te bepalen of het Klembord gegevens bevat in de opgegeven indeling of een compatibele indeling voordat u deze met deze methode opvraagt.

Als deze methode geen gegevens in de opgegeven indeling kan vinden, wordt geprobeerd de gegevens te converteren naar de indeling. Als de gegevens niet kunnen worden geconverteerd naar de opgegeven indeling of als de gegevens zijn opgeslagen met automatische conversie ingesteld falseop, retourneert nulldeze methode.

Note

Gegevens kunnen worden geconverteerd naar een andere indeling als deze is opgeslagen, waarbij wordt opgegeven dat conversie is toegestaan en of de aangevraagde indeling compatibel is met de opgeslagen indeling. Gegevens die zijn opgeslagen als Unicode, kunnen bijvoorbeeld worden geconverteerd naar tekst.

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.

Gebruik de SetData methode om gegevens toe te voegen aan het Klembord in een bepaalde indeling.

Van toepassing op

Zie ook