Clipboard.GetData(String) Metoda

  • Odwołanie

Definicja

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

Pobiera dane ze Schowka w określonym formacie.

public:
 static System::Object ^ GetData(System::String ^ format);
public static object GetData (string format);
public static object? GetData (string format);
static member GetData : string -> obj
Public Shared Function GetData (format As String) As Object

Parametry

format
String

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

Zwraca

Object

Reprezentujący Object dane Schowka lub null jeśli Schowek nie zawiera żadnych danych, które znajdują się w określonym format formacie lub można je przekonwertować na ten format.

Wyjątki

ExternalException

Nie można wyczyścić Schowka. Zwykle dzieje się tak, gdy Schowek jest używany przez inny proces.

ThreadStateException

Bieżący wątek nie jest w trybie jednowątkowy (STA). Dodaj element 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

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

Jeśli ta metoda nie może odnaleźć danych w określonym formacie, próbuje przekonwertować dane na format. Jeśli nie można przekonwertować danych na określony format lub jeśli dane były przechowywane z automatycznym zestawem konwersji na falsewartość , ta metoda zwraca wartość null.

Uwaga

Dane można przekonwertować na inny format, jeśli zostały zapisane, 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.

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

SetData Użyj metody , aby dodać dane do Schowka w określonym formacie.

Dotyczy

Zobacz też