Clipboard.SetDataObject Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Archivia un oggetto dati specificato sugli Appunti di sistema.

Overload

SetDataObject(Object)	Colloca un oggetto dati specificato non permanente sugli Appunti di sistema.
SetDataObject(Object, Boolean)	Colloca un oggetto dati specificato sugli Appunti di sistema ed accetta un parametro Booleano che indica se l'oggetto dati deve essere lasciato sugli Appunti quando l'applicazione termina.

SetDataObject(Object)

Colloca un oggetto dati specificato non permanente sugli Appunti di sistema.

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)

Parametri

data

Object

Un oggetto dati (un oggetto che implementa IDataObject) da collocare sugli Appunti di sistema.

Eccezioni

ArgumentNullException

data è null.

ExternalException

Si è verificato un errore durante l'accesso agli Appunti. I dettagli dell'eccezione includeranno un oggetto HResult che identifica l'errore specifico. A tal proposito si veda ErrorCode.

Commenti

Per impostazione predefinita, i dati inseriti negli Appunti di sistema con SetDataObject vengono cancellati automaticamente dagli Appunti quando l'applicazione viene chiusa.

Nota

Il comportamento predefinito della cancellazione degli Appunti all'uscita dell'applicazione potrebbe essere diverso da altre implementazioni, che potrebbero lasciare i dati negli Appunti all'uscita dall'applicazione anziché cancellarli per impostazione predefinita. Usare l'overload SetDataObject e specificare il copy parametro come true se non si desidera cancellare i dati dagli Appunti all'uscita dall'applicazione.

DataObject fornisce un'implementazione di base dell'interfaccia IDataObject .

Vedi anche

• GetDataObject()

SetDataObject(Object, Boolean)

Colloca un oggetto dati specificato sugli Appunti di sistema ed accetta un parametro Booleano che indica se l'oggetto dati deve essere lasciato sugli Appunti quando l'applicazione termina.

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)

Parametri

data

Object

Un oggetto dati (un oggetto che implementa IDataObject) da collocare sugli Appunti di sistema.

copy

Boolean

true per lasciare i dati sugli Appunti di sistema quando l'applicazione termina; false per cancellare i dati dagli Appunti di sistema quando l'applicazione termina.

Eccezioni

ArgumentNullException

data è null.

ExternalException

Si è verificato un errore durante l'accesso agli Appunti. I dettagli dell'eccezione includeranno un oggetto HResult che identifica l'errore specifico. A tal proposito si veda ErrorCode.

Esempio

Nell'esempio seguente viene illustrato l'uso di questo metodo.

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

Commenti

DataObject fornisce un'implementazione di base dell'interfaccia IDataObject . IsCurrent determina l'oggetto dati inserito in precedenza negli Appunti dall'ultima SetDataObject chiamata.

Vedi anche

• GetDataObject()