Clipboard.SetDataObject Méthode

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Stocke un objet de données spécifié sur le Presse-papiers système.

Surcharges

SetDataObject(Object)	Place un objet de données non persistant spécifié sur le Presse-papiers système.
SetDataObject(Object, Boolean)	Place un objet de données spécifié sur le Presse-papiers système et accepte un paramètre booléen qui indique si l'objet de données doit être laissé sur le Presse-papiers lors de la fermeture de l'application.

SetDataObject(Object)

Place un objet de données non persistant spécifié sur le Presse-papiers système.

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)

Paramètres

data

Object

Objet de données (un objet qui implémente IDataObject) à placer sur le Presse-papiers système.

Attributs

SecurityCriticalAttribute

Exceptions

ArgumentNullException

data a la valeur null.

ExternalException

Une erreur s'est produite lors de l'accès au Presse-papiers. Les détails de l'exception incluent un HResult qui identifie l'erreur spécifique. Consultez ErrorCode.

Remarques

Par défaut, les données placées dans le Presse-papiers système avec sont SetDataObject automatiquement effacées du Presse-papiers lorsque l’application quitte.

Notes

Le comportement par défaut de l’effacement du Presse-papiers sur la sortie de l’application peut différer d’autres implémentations, ce qui peut laisser les données dans le Presse-papiers sur la sortie de l’application plutôt que de l’effacer par défaut. Utilisez la surcharge et spécifiez le SetDataObject copy paramètre comme true si vous ne souhaitez pas effacer les données du Presse-papiers sur la sortie de l’application.

DataObject fournit une implémentation de base de l’interface IDataObject .

Voir aussi

• GetDataObject()

SetDataObject(Object, Boolean)

Place un objet de données spécifié sur le Presse-papiers système et accepte un paramètre booléen qui indique si l'objet de données doit être laissé sur le Presse-papiers lors de la fermeture de l'application.

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)

Paramètres

data

Object

Objet de données (un objet qui implémente IDataObject) à placer sur le Presse-papiers système.

copy

Boolean

true pour laisser les données sur le Presse-papiers système lors de la fermeture de l'application ; false pour effacer les données du Presse-papiers système lors de la fermeture de l'application.

Attributs

SecurityCriticalAttribute

Exceptions

ArgumentNullException

data a la valeur null.

ExternalException

Une erreur s'est produite lors de l'accès au Presse-papiers. Les détails de l'exception incluent un HResult qui identifie l'erreur spécifique. Consultez ErrorCode.

Exemples

L’exemple suivant illustre l’utilisation de cette méthode.

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

Remarques

DataObject fournit une implémentation de base de l’interface IDataObject . IsCurrent détermine l’objet de données précédemment placé dans le Presse-papiers par le dernier SetDataObject appel.

Voir aussi

• GetDataObject()