Udostępnij za pośrednictwem

Clipboard.ContainsData(String) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Wskazuje, czy w Schowku znajdują się dane, które mają określony format, czy można je przekonwertować na ten format.

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

Parametry

format
String

Format danych do wyszukania. Zobacz, aby zapoznać się DataFormats ze wstępnie zdefiniowanymi formatami.

Zwraca

Boolean

true jeśli w schowku znajdują się dane, które znajdują się w określonym format formacie lub można je przekonwertować na ten format; w przeciwnym razie false.

Wyjątki

ExternalException

Nie można wyczyścić schowka. Zwykle występuje to, gdy schowek jest używany przez inny proces.

ThreadStateException

Bieżący wątek nie jest w trybie jednowątkowego mieszkania (STA). Dodaj metodę STAThreadAttribute do metody aplikacji Main .

Przykłady

W poniższym przykładzie pokazano ten element członkowski.

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

Uwagi

Klasa DataFormats zawiera wstępnie zdefiniowane nazwy formatów, których można użyć z tą metodą.

Użyj tej metody, aby określić, czy Schowek zawiera dane w określonym formacie, czy zgodny format przed pobraniem GetData go za pomocą metody .

Uwaga

Dane można przekonwertować na inny format, jeśli były przechowywane, określając, że konwersja jest dozwolona, a żądany format jest zgodny z zapisanym formatem. Na przykład dane przechowywane jako Unicode można przekonwertować na tekst.

Klasa Clipboard może być używana tylko w wątkach ustawionych na tryb pojedynczego wątku (STA). Aby użyć tej klasy, upewnij się, że Main metoda jest oznaczona atrybutem STAThreadAttribute .

Dotyczy

Zobacz też