Clipboard.ContainsData(String) Methode

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
Clipboard.cs
Quelle:
Clipboard.cs
Quelle:
Clipboard.cs
Quelle:
Clipboard.cs
Quelle:
Clipboard.cs

Gibt an, ob daten in der Zwischenablage vorhanden sind, die sich im angegebenen Format befinden oder in dieses Format 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 daten, nach der gesucht werden soll. Informationen zu vordefinierten Formaten finden Sie DataFormats unter

Gibt zurück

Boolean

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

Ausnahmen

ExternalException

Die Zwischenablage konnte nicht gelöscht werden. Dies tritt in der Regel auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.

ThreadStateException

Der aktuelle Thread befindet sich nicht im Sta-Modus (Single Threaded Apartment). Fügen Sie die STAThreadAttribute Methode Ihrer Anwendung Main 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 einem kompatiblen Format enthält, bevor Sie sie mit der GetData Methode abrufen.

Note

Daten können in ein anderes Format konvertiert werden, wenn sie gespeichert wurde, wenn sie angegeben wurde, dass die Konvertierung zulässig ist, und wenn das angeforderte Format mit dem gespeicherten Format kompatibel ist. Beispielsweise können als Unicode gespeicherte Daten 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 die Main-Methode mit dem STAThreadAttribute-Attribut markiert ist.

Gilt für:

Weitere Informationen