Udostępnij za pośrednictwem

Clipboard.SetData(String, Object) Metoda

  • Odwołanie

Definicja

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

Czyści Schowek, a następnie dodaje dane w określonym formacie.

public:
 static void SetData(System::String ^ format, System::Object ^ data);
public static void SetData (string format, object data);
static member SetData : string * obj -> unit
Public Shared Sub SetData (format As String, data As Object)

Parametry

format
String

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

data
Object

Reprezentacja Object danych do dodania.

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 .

ArgumentNullException

data to null.

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

Jeśli nie znasz formatu aplikacji docelowej, możesz przechowywać dane w wielu formatach przy użyciu tej metody.

Dane przechowywane przy użyciu tej metody można przekonwertować na zgodny format podczas pobierania.

Aby pobrać dane ze Schowka w określonym formacie, najpierw użyj ContainsData metody , aby określić, czy Schowek zawiera dane w tym formacie przed pobraniem ich za GetData pomocą metody .

Uwaga

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 .

Dotyczy

Zobacz też