Clipboard.SetDataObject Método

Definición

Espacio de nombres:
System.Windows
Ensamblado:
PresentationCore.dll

Almacena un objeto de datos especificado en el Portapapeles del sistema.

Sobrecargas

Nombre Description
SetDataObject(Object)

Coloca un objeto de datos no persistente especificado en el Portapapeles del sistema.
SetDataObject(Object, Boolean)

Coloca un objeto de datos especificado en el Portapapeles del sistema y acepta un parámetro booleano que indica si el objeto de datos debe dejarse en el Portapapeles cuando se cierra la aplicación.

SetDataObject(Object)

Coloca un objeto de datos no persistente especificado en el Portapapeles del sistema.

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)

Parámetros

data
Object

Objeto de datos (un objeto que implementa IDataObject) para colocarlo en el Portapapeles del sistema.

Atributos
SecurityCriticalAttribute

Excepciones

ArgumentNullException

data es null.

ExternalException

Error al acceder al Portapapeles. Los detalles de la excepción incluirán un HResult que identifica el error específico; vea ErrorCode.

Comentarios

De forma predeterminada, los datos colocados en el Portapapeles del sistema con SetDataObject se borran automáticamente del Portapapeles cuando se cierra la aplicación.

Note

El comportamiento predeterminado de borrar el Portapapeles en la salida de la aplicación podría diferir de otras implementaciones, lo que podría dejar datos en el Portapapeles en la salida de la aplicación en lugar de borrarlo de forma predeterminada. Use la SetDataObject sobrecarga y especifique el copy parámetro como true si no desea borrar los datos del Portapapeles en la salida de la aplicación.

DataObject proporciona una implementación básica de la IDataObject interfaz.

Consulte también

Se aplica a

SetDataObject(Object, Boolean)

Coloca un objeto de datos especificado en el Portapapeles del sistema y acepta un parámetro booleano que indica si el objeto de datos debe dejarse en el Portapapeles cuando se cierra la aplicación.

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)

Parámetros

data
Object

Objeto de datos (un objeto que implementa IDataObject) para colocarlo en el Portapapeles del sistema.

copy
Boolean

true para dejar los datos en el Portapapeles del sistema cuando se cierre la aplicación; false para borrar los datos del Portapapeles del sistema cuando se cierra la aplicación.

Atributos
SecurityCriticalAttribute

Excepciones

ArgumentNullException

data es null.

ExternalException

Error al acceder al Portapapeles. Los detalles de la excepción incluirán un HResult que identifica el error específico; vea ErrorCode.

Ejemplos

En el ejemplo siguiente se muestra el uso de este método.


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

Comentarios

DataObject proporciona una implementación básica de la IDataObject interfaz. IsCurrent determina el objeto de datos colocado previamente en el Portapapeles por la última SetDataObject llamada.

Consulte también

Se aplica a