DataObject Clase

Referencia

Definición

Espacio de nombres:: System.Windows

Ensamblado:: PresentationCore.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona una implementación básica de la interfaz IDataObject, que define un mecanismo independiente del formato para transferir datos.

public ref class DataObject sealed : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::IDataObject

public sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.IDataObject

type DataObject = class
    interface IDataObject
    interface IDataObject

Public NotInheritable Class DataObject
Implements IDataObject, IDataObject

Herencia: Object
DataObject

Implementaciones: IDataObject IDataObject

Ejemplos

En el siguiente ejemplo se muestra cómo utilizar esta clase.

string stringData = "Some string data to store...";
string dataFormat = DataFormats.UnicodeText;
DataObject dataObject = new DataObject(dataFormat, stringData);

Dim stringData As String = "Some string data to store..."
Dim dataFormat As String = DataFormats.UnicodeText
Dim dataObject As New DataObject(dataFormat, stringData)

Comentarios

Importante

Llamar a métodos de esta clase con datos que no son de confianza supone un riesgo de seguridad. Llame a los métodos de esta clase solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.

Constructores

DataObject()	Inicializa una nueva instancia de la clase DataObject.
DataObject(Object)	Inicializa una nueva instancia de la clase DataObject que contiene los datos especificados.
DataObject(String, Object)	Inicializa una nueva instancia de la clase DataObject que contiene los datos especificados y su formato asociado; una cadena especifica el formato.
DataObject(String, Object, Boolean)	Inicializa una nueva instancia de la clase DataObject que contiene los datos especificados y su formato asociado; una cadena especifica el formato. Esta sobrecarga incluye una marca de tipo `Boolean` para indicar si los datos se pueden convertir en otro formato durante el proceso de recuperación.
DataObject(Type, Object)	Inicializa una nueva instancia de la clase DataObject que contiene los datos especificados y su formato asociado; el formato de los datos lo especifica un objeto Type.

Campos

CopyingEvent	Identifica el evento adjunto Copying.
PastingEvent	Identifica el evento adjunto Pasting.
SettingDataEvent	Identifica el evento adjunto SettingData.

Métodos

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Agrega un controlador de eventos Copying a un objeto de dependencia especificado.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)	Agrega un controlador de eventos Pasting a un objeto de dependencia especificado.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Agrega un controlador de eventos SettingData a un objeto de dependencia especificado.
ContainsAudio()	Consulta la presencia de datos con el formato de datos WaveAudio en un objeto de datos.
ContainsFileDropList()	Consulta la presencia de datos con el formato de datos FileDrop en un objeto de datos.
ContainsImage()	Consulta la presencia de datos con el formato de datos Bitmap en un objeto de datos.
ContainsText()	Consulta la presencia de datos con el formato de UnicodeText en un objeto de datos.
ContainsText(TextDataFormat)	Consulta la presencia de datos con un formato de datos de texto en un objeto de datos.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetAudioStream()	Devuelve una secuencia que contiene los datos en el formato de datos de WaveAudio.
GetData(String)	Devuelve los datos en un formato especificado por una cadena.
GetData(String, Boolean)	Devuelve un objeto de datos con un formato especificado, convirtiendo opcionalmente los datos al formato especificado.
GetData(Type)	Devuelve un objeto de datos con un formato especificado por un objeto Type.
GetDataPresent(String)	Determina si los datos están disponibles en un formato especificado por una cadena o se pueden convertir a él.
GetDataPresent(String, Boolean)	Determina si los datos están disponibles en un formato especificado o se pueden convertir a él. Un marcador de tipo `Boolean` indica si se comprueba si los datos se pueden convertir al formato especificado si no están disponibles en ese formato.
GetDataPresent(Type)	Determina si los datos están disponibles en un formato especificado por un objeto Type o se pueden convertir a él.
GetFileDropList()	Devuelve una colección de cadenas que contiene una lista de archivos colocados.
GetFormats()	Devuelve una lista de los formatos en los que se almacenan los datos de este objeto de datos; o bien, a los que se pueden convertir.
GetFormats(Boolean)	Devuelve una lista de formatos en los que se almacenan los datos de este objeto de datos. Una marca `Boolean` indica si también se incluyen los formatos a los que los datos se convertirán automáticamente.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetImage()	Devuelve un objeto BitmapSource que contiene los datos con el formato de Bitmap.
GetText()	Devuelve una cadena que contiene los datos de UnicodeText de este objeto de datos.
GetText(TextDataFormat)	Devuelve una cadena que contiene los datos de texto del formato especificado en este objeto de datos.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Quita un controlador de eventos Copying de un objeto de dependencia especificado.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Quita un controlador de eventos Pasting de un objeto de dependencia especificado.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Quita un controlador de eventos SettingData de un objeto de dependencia especificado.
SetAudio(Byte[])	Almacena datos de audio (formato de datos de WaveAudio) en este objeto de datos. Los datos de audio se especifican como matriz de bytes.
SetAudio(Stream)	Almacena datos de audio (formato de datos de WaveAudio) en este objeto de datos. Los datos de audio se especifican como secuencia.
SetData(Object)	Almacena los datos especificados en este objeto de datos, determinando automáticamente el formato de los datos del tipo de objeto de origen.
SetData(String, Object)	Almacena los datos especificados en este objeto de datos, junto con uno o varios formatos de datos especificados; el formato de datos se especifica mediante una cadena.
SetData(String, Object, Boolean)	Almacena los datos especificados en este objeto de datos, junto con uno o más formatos de datos especificados. Esta sobrecarga incluye un marcador de tipo `Boolean` para indicar si los datos se pueden convertir a otro formato en el proceso de recuperación.
SetData(Type, Object)	Almacena los datos especificados en este objeto de datos, junto con uno o más formatos de datos especificados; un objeto Type especifica el formato de los datos.
SetFileDropList(StringCollection)	Almacena los datos de FileDrop en este objeto de datos. La lista de archivos colocada se especifica como colección de cadenas.
SetImage(BitmapSource)	Almacena los datos de Bitmap en este objeto de datos. Los datos de la imagen se especifican como BitmapSource.
SetText(String)	Almacena los datos de UnicodeText, especificados como cadena, en este objeto de datos.
SetText(String, TextDataFormat)	Almacena los datos de texto en este objeto de datos. El formato de los datos de texto que se van a almacenar se especifica con un miembro de TextDataFormat.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos adjuntos

Copying	Se produce cuando el objeto de dependencia asociado ha preparado formatos de datos adecuados que representan la selección de copia, ha agregado los formatos de la selección de copia a un elemento DataObject y está listo para colocar el elemento DataObject en Clipboard o iniciar una operación de arrastrar y colocar.
Pasting	Se produce cuando el objeto de dependencia asociado está listo para pegar datos.
SettingData	Se produce cuando el objeto de dependencia asociado intenta agregar un nuevo formato de datos a DataObject.

Implementaciones de interfaz explícitas

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Crea una conexión entre un objeto de datos y un receptor de consulta. Este método es invocado por un objeto que admite un receptor de consulta y permite que a dicho receptor se le notifiquen los cambios realizados en los datos del objeto.
IDataObject.DUnadvise(Int32)	Destruye una conexión de notificación que se había establecido previamente.
IDataObject.EnumDAdvise(IEnumSTATDATA)	Crea un objeto que se puede utilizar para enumerar las conexiones de consulta actuales.
IDataObject.EnumFormatEtc(DATADIR)	Crea un objeto para enumerar las estructuras FORMATETC para un objeto de datos. Estas estructuras se utilizan en llamadas a los métodos GetData(FORMATETC, STGMEDIUM) o SetData(FORMATETC, STGMEDIUM, Boolean).
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Proporciona una estructura FORMATETC estándar que equivale lógicamente a una estructura más compleja. Utilice este método para determinar si dos estructuras FORMATETC diferentes devolverían los mismos datos, eliminando la necesidad de una representación duplicada.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Obtiene los datos de un objeto de datos de origen. El método GetData(FORMATETC, STGMEDIUM), que es invocado por un consumidor de datos, representa los datos descritos en la estructura FORMATETC especificada y los transfiere a través de la estructura STGMEDIUM especificada. A continuación, el llamador asume la responsabilidad de liberar la estructura STGMEDIUM.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Obtiene los datos de un objeto de datos de origen. Este método, que es invocado por un consumidor de datos, se diferencia del método GetData(FORMATETC, STGMEDIUM) en que el llamador debe asignar y liberar el medio de almacenamiento especificado.
IDataObject.QueryGetData(FORMATETC)	Determina si el objeto de datos es capaz de representar los datos descritos en la estructura FORMATETC. Los objetos que intentan una operación de pegar o colocar pueden llamar a este método antes de llamar a GetData(FORMATETC, STGMEDIUM) para obtener una indicación de si la operación puede tener éxito.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)	Transfiere los datos al objeto que implementa este método. Este método es invocado por un objeto que contiene un origen de datos.

Se aplica a

Consulte también

Cargar un ejemplo de archivo quitado

Compartir a través de