Clipboard.SetDataObject Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Speichert ein angegebenes Datenobjekt in der Systemzwischenablage.

Überlädt

SetDataObject(Object)	Platziert ein angegebenes nicht permanentes Datenobjekt in der Systemzwischenablage.
SetDataObject(Object, Boolean)	Platziert ein angegebenes Datenobjekt in der Systemzwischenablage und nimmt einen booleschen Parameter an, der angibt, ob das Datenobjekt beim Beenden der Anwendung in der Zwischenablage belassen werden soll.

SetDataObject(Object)

Platziert ein angegebenes nicht permanentes Datenobjekt in der Systemzwischenablage.

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

public static void SetDataObject (object data);

static member SetDataObject : obj -> unit

Public Shared Sub SetDataObject (data As Object)

Parameter

data

Object

Ein Datenobjekt (ein Objekt, das IDataObject implementiert), das in der Systemzwischenablage platziert werden soll.

Ausnahmen

ArgumentNullException

data ist null.

ExternalException

Fehler beim Zugriff auf die Zwischenablage. Die Ausnahmedetails schließen ein HResult ein, das den spezifischen Fehler identifiziert. Siehe ErrorCode.

Hinweise

Standardmäßig werden Daten in der Systemablage mit SetDataObject automatisch aus der Zwischenablage gelöscht, wenn die Anwendung beendet wird.

Hinweis

Das Standardverhalten des Löschens der Zwischenablage beim Beenden der Anwendung unterscheidet sich möglicherweise von anderen Implementierungen, die beim Beenden der Anwendung möglicherweise Daten in der Zwischenablage lassen, anstatt sie standardmäßig zu löschen. Verwenden Sie die SetDataObject Überladung, und geben Sie den copy Parameter so an, als true ob Sie beim Beenden der Anwendung keine Daten aus der Zwischenablage löschen möchten.

DataObject stellt eine grundlegende Implementierung der Schnittstelle bereit IDataObject .

Weitere Informationen

• GetDataObject()

SetDataObject(Object, Boolean)

Platziert ein angegebenes Datenobjekt in der Systemzwischenablage und nimmt einen booleschen Parameter an, der angibt, ob das Datenobjekt beim Beenden der Anwendung in der Zwischenablage belassen werden soll.

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

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

static member SetDataObject : obj * bool -> unit

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

Parameter

data

Object

Ein Datenobjekt (ein Objekt, das IDataObject implementiert), das in der Systemzwischenablage platziert werden soll.

copy

Boolean

true, um die Daten beim Beenden der Anwendung in der Systemzwischenablage zu belassen, false, um die Daten beim Beenden der Anwendung aus der Systemzwischenablage zu löschen.

Ausnahmen

ArgumentNullException

data ist null.

ExternalException

Fehler beim Zugriff auf die Zwischenablage. Die Ausnahmedetails schließen ein HResult ein, das den spezifischen Fehler identifiziert. Siehe ErrorCode.

Beispiele

Im folgenden Beispiel wird die Verwendung dieser Methode veranschaulicht.

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

Hinweise

DataObject stellt eine grundlegende Implementierung der Schnittstelle bereit IDataObject . IsCurrent bestimmt das Datenobjekt, das zuvor durch den letzten SetDataObject Aufruf in der Zwischenablage platziert wurde.

Weitere Informationen

• GetDataObject()