Clipboard.ContainsData(String) Methode

Definitie

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

Hiermee wordt aangegeven of er gegevens op het Klembord staan die de opgegeven indeling hebben of naar die indeling kunnen worden geconverteerd.

public:
 static bool ContainsData(System::String ^ format);
public static bool ContainsData(string format);
static member ContainsData : string -> bool
Public Shared Function ContainsData (format As String) As Boolean

Parameters

format
String

De indeling van de te zoeken gegevens. Zie DataFormats voor vooraf gedefinieerde indelingen.

Retouren

Boolean

true als er gegevens op het Klembord staan die zich in de opgegeven format indeling bevinden of naar die indeling kunnen worden geconverteerd, falseanders.

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

De DataFormats klasse bevat vooraf gedefinieerde indelingsnamen die u met deze methode kunt gebruiken.

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

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.

Van toepassing op

Zie ook