Clipboard.ContainsData(String) Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs

Anger om det finns data i Urklipp som har det angivna formatet eller kan konverteras till det formatet.

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

Parametrar

format
String

Formatet på de data som ska sökas efter. Se DataFormats fördefinierade format.

Returer

Boolean

trueom det finns data i Urklipp som finns i det angivna format eller kan konverteras till det formatet, annars . false

Undantag

ExternalException

Urklipp kunde inte rensas. Detta inträffar vanligtvis när Urklipp används av en annan process.

ThreadStateException

Den aktuella tråden är inte i sta-läge (single-threaded apartment). Lägg till i STAThreadAttribute programmets Main metod.

Exempel

I följande exempel visas den här medlemmen.

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

Kommentarer

Klassen DataFormats innehåller fördefinierade formatnamn som du kan använda med den här metoden.

Använd den här metoden för att avgöra om Urklipp innehåller data i det angivna formatet eller ett kompatibelt format innan du hämtar dem med GetData metoden.

Note

Data kan konverteras till ett annat format om de har lagrats och anger att konvertering tillåts och om det begärda formatet är kompatibelt med det lagrade formatet. Data som lagras som Unicode kan till exempel konverteras till text.

Klassen Clipboard kan endast användas i trådar som är inställda på sta-läge (single thread apartment). Om du vill använda den här klassen kontrollerar du att din Main-metod har markerats med attributet STAThreadAttribute.

Gäller för

Se även