Clipboard.SetDataObject Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationCore.dll

Przechowuje określony obiekt danych w Schowku systemowym.

Przeciążenia

SetDataObject(Object)	Umieszcza określony obiekt danych nietrwale na schowku systemowym.
SetDataObject(Object, Boolean)	Umieszcza określony obiekt danych w Schowku systemowym i akceptuje parametr logiczny wskazujący, czy obiekt danych powinien pozostać w Schowku po zakończeniu działania aplikacji.

SetDataObject(Object)

Umieszcza określony obiekt danych nietrwale na schowku systemowym.

public:
 static void SetDataObject(System::Object ^ data);

[System.Security.SecurityCritical]
public static void SetDataObject (object data);

public static void SetDataObject (object data);

[<System.Security.SecurityCritical>]
static member SetDataObject : obj -> unit

static member SetDataObject : obj -> unit

Public Shared Sub SetDataObject (data As Object)

Parametry

data

Object

Obiekt danych (obiekt implementujący IDataObject) do umieszczenia w schowku systemowym.

Atrybuty

SecurityCriticalAttribute

Wyjątki

ArgumentNullException

data to null.

ExternalException

Wystąpił błąd podczas uzyskiwania dostępu do Schowka. Szczegóły wyjątku będą zawierać element HResult identyfikujący określony błąd. Zobacz ErrorCode.

Uwagi

Domyślnie dane umieszczone w schowku SetDataObject systemowym są automatycznie czyszczone ze Schowka po zakończeniu działania aplikacji.

Uwaga

Domyślne zachowanie czyszczenia Schowka przy zamykaniu aplikacji może różnić się od innych implementacji, co może spowodować pozostawienie danych w Schowku podczas zamykania aplikacji, a nie wyczyszczenie go domyślnie. Użyj przeciążenia SetDataObject i określ parametr tak copy , jakby true dane nie zostały wyczyszczone ze Schowka na zamknięciu aplikacji.

DataObject Zapewnia podstawową implementację interfejsu IDataObject .

Zobacz też

• GetDataObject()

SetDataObject(Object, Boolean)

Umieszcza określony obiekt danych w Schowku systemowym i akceptuje parametr logiczny wskazujący, czy obiekt danych powinien pozostać w Schowku po zakończeniu działania aplikacji.

public:
 static void SetDataObject(System::Object ^ data, bool copy);

[System.Security.SecurityCritical]
public static void SetDataObject (object data, bool copy);

public static void SetDataObject (object data, bool copy);

[<System.Security.SecurityCritical>]
static member SetDataObject : obj * bool -> unit

static member SetDataObject : obj * bool -> unit

Public Shared Sub SetDataObject (data As Object, copy As Boolean)

Parametry

data

Object

Obiekt danych (obiekt implementujący IDataObject) do umieszczenia w schowku systemowym.

copy

Boolean

true aby pozostawić dane w schowku systemowym po zakończeniu działania aplikacji; false aby wyczyścić dane ze Schowka systemowego po zakończeniu działania aplikacji.

Atrybuty

SecurityCriticalAttribute

Wyjątki

ArgumentNullException

data to null.

ExternalException

Wystąpił błąd podczas uzyskiwania dostępu do Schowka. Szczegóły wyjątku będą zawierać element HResult identyfikujący określony błąd. Zobacz ErrorCode.

Przykłady

W poniższym przykładzie pokazano użycie tej metody.

               // For this example, the data to be placed on the clipboard is a simple
               // string.
               string textData = "I want to put this string on the clipboard.";
               // The example will enable auto-conversion of data for this data object.
               bool autoConvert = true;

               // Create a new data object, specifying the data format, data to encapsulate, and enabling
               // auto-conversion services.
               DataObject data = new DataObject(DataFormats.UnicodeText, (Object)textData, autoConvert);
               
               // If the data to be copied is supposed to be persisted after the application ends, 
               // then set the second parameter of SetDataObject to true.
               if(persistentData)
               {
                   // Place the persisted data on the clipboard.
                   Clipboard.SetDataObject(data, true);
               }
               else
               {
                   // Place the non-persisted data on the clipboard.
                   Clipboard.SetDataObject(data, false);
               }

               // If you keep a copy of the source data object, you can use the IsCurrent method to see if
               // the data object is still on the clipboard.
               bool isOriginalDataObject = Clipboard.IsCurrent(data);

' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."
' The example will enable auto-conversion of data for this data object.
Dim autoConvert As Boolean = True

' Create a new data object, specifying the data format, data to encapsulate, and enabling
' auto-conversion services.
Dim data As New DataObject(DataFormats.UnicodeText, CType(textData, Object), autoConvert)

' If the data to be copied is supposed to be persisted after the application ends, 
' then set the second parameter of SetDataObject to true.
If persistentData Then
    ' Place the persisted data on the clipboard.
    Clipboard.SetDataObject(data, True)
Else
    ' Place the non-persisted data on the clipboard.
    Clipboard.SetDataObject(data, False)
End If

' If you keep a copy of the source data object, you can use the IsCurrent method to see if
' the data object is still on the clipboard.
Dim isOriginalDataObject As Boolean = Clipboard.IsCurrent(data)

Uwagi

DataObject Zapewnia podstawową implementację interfejsu IDataObject . IsCurrent określa obiekt danych wcześniej umieszczony w schowku przez ostatnie SetDataObject wywołanie.

Zobacz też

• GetDataObject()