Freigeben über

Clipboard.ContainsData(String) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Gibt an, ob sich in der Zwischenablage Daten befinden, die dem angegebenen Format entsprechen oder in dieses konvertiert werden können.

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

Parameter

format
String

Das Format der zu suchenden Daten. Vordefinierte Formate finden Sie unter DataFormats.

Gibt zurück

Boolean

true, wenn in der Zwischenablage Daten im angegebenen format oder Daten vorhanden sind, die in dieses Format konvertiert werden können. Andernfalls false.

Ausnahmen

ExternalException

Die Zwischenablage konnte nicht gelöscht werden. Dies tritt i. d. R. auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.

ThreadStateException

Der aktuelle Thread befindet sich nicht im STA-Modus (Singlethread-Apartment). Fügen Sie der Main-Methode der Anwendung das STAThreadAttribute hinzu.

Beispiele

Im folgenden Beispiel wird dieses Element veranschaulicht.

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

Hinweise

Die DataFormats Klasse enthält vordefinierte Formatnamen, die Sie mit dieser Methode verwenden können.

Verwenden Sie diese Methode, um zu bestimmen, ob die Zwischenablage Daten im angegebenen Format oder ein kompatibles Format enthält, bevor Sie sie mit der GetData Methode abrufen.

Hinweis

Daten können in ein anderes Format konvertiert werden, wenn sie gespeichert wurde, um anzugeben, dass die Konvertierung zulässig ist, und wenn das angeforderte Format mit dem gespeicherten Format kompatibel ist. Daten, die als Unicode gespeichert sind, können beispielsweise in Text konvertiert werden.

Die Clipboard Klasse kann nur in Threads verwendet werden, die auf den Sta-Modus (Single Thread Apartment) festgelegt sind. Um diese Klasse zu verwenden, stellen Sie sicher, dass Ihre Main Methode mit dem STAThreadAttribute Attribut gekennzeichnet ist.

Gilt für

Siehe auch