DataObject DataObject DataObject DataObject Class

Definición

Proporciona una implementación básica de la interfaz IDataObject, que define un mecanismo independiente del formato para transferir datos.Provides a basic implementation of the IDataObject interface, which defines a format-independent mechanism for transferring data.

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
DataObjectDataObjectDataObjectDataObject
Implementaciones

Ejemplos

En el siguiente ejemplo se muestra cómo utilizar esta clase.The following example shows how to use this class.

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.Calling methods from this class with untrusted data is a security risk. Llame a los métodos de esta clase solo con datos de confianza.Call the methods from this class only with trusted data. Para obtener más información, vea Data Validation (Validación de datos).For more information, see Data Validation.

Constructores

DataObject() DataObject() DataObject() DataObject()

Inicializa una nueva instancia de la clase DataObject.Initializes a new instance of the DataObject class.

DataObject(Object) DataObject(Object) DataObject(Object) DataObject(Object)

Inicializa una nueva instancia de la clase DataObject que contiene los datos especificados.Initializes a new instance of the DataObject class that contains the specified data.

DataObject(String, Object) DataObject(String, Object) DataObject(String, Object) 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.Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string.

DataObject(String, Object, Boolean) DataObject(String, Object, Boolean) DataObject(String, Object, Boolean) 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.Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string. 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.This overload includes a Boolean flag to indicate whether the data may be converted to another format on retrieval.

DataObject(Type, Object) DataObject(Type, Object) DataObject(Type, Object) 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.Initializes a new instance of the DataObject class that contains the specified data and its associated format; the data format is specified by a Type object.

Campos

CopyingEvent CopyingEvent CopyingEvent CopyingEvent

Identifica el evento adjunto Copying.Identifies the Copying attached event.

PastingEvent PastingEvent PastingEvent PastingEvent

Identifica el evento adjunto Pasting.Identifies the Pasting attached event.

SettingDataEvent SettingDataEvent SettingDataEvent SettingDataEvent

Identifica el evento adjunto SettingData.Identifies the SettingData attached event.

Métodos

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Agrega un controlador de eventos Copying a un objeto de dependencia especificado.Adds a Copying event handler to a specified dependency object.

AddPastingHandler(DependencyObject, DataObjectPastingEventHandler) AddPastingHandler(DependencyObject, DataObjectPastingEventHandler) AddPastingHandler(DependencyObject, DataObjectPastingEventHandler) AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)

Agrega un controlador de eventos Pasting a un objeto de dependencia especificado.Adds a Pasting event handler to a specified dependency object.

AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Agrega un controlador de eventos SettingData a un objeto de dependencia especificado.Adds a SettingData event handler to a specified dependency object.

ContainsAudio() ContainsAudio() ContainsAudio() ContainsAudio()

Consulta la presencia de datos con el formato de datos WaveAudio en un objeto de datos.Queries a data object for the presence of data in the WaveAudio data format.

ContainsFileDropList() ContainsFileDropList() ContainsFileDropList() ContainsFileDropList()

Consulta la presencia de datos con el formato de datos FileDrop en un objeto de datos.Queries a data object for the presence of data in the FileDrop data format.

ContainsImage() ContainsImage() ContainsImage() ContainsImage()

Consulta la presencia de datos con el formato de datos Bitmap en un objeto de datos.Queries a data object for the presence of data in the Bitmap data format.

ContainsText() ContainsText() ContainsText() ContainsText()

Consulta la presencia de datos con el formato de UnicodeText en un objeto de datos.Queries a data object for the presence of data in the UnicodeText format.

ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat)

Consulta la presencia de datos con un formato de datos de texto en un objeto de datos.Queries a data object for the presence of data in a text data format.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetAudioStream() GetAudioStream() GetAudioStream() GetAudioStream()

Devuelve una secuencia que contiene los datos en el formato de datos de WaveAudio.Returns a stream that contains data in the WaveAudio data format.

GetData(String) GetData(String) GetData(String) GetData(String)

Devuelve los datos en un formato especificado por una cadena.Returns data in a format specified by a string.

GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean)

Devuelve un objeto de datos con un formato especificado, convirtiendo opcionalmente los datos al formato especificado.Returns a data object in a specified format, optionally converting the data to the specified format.

GetData(Type) GetData(Type) GetData(Type) GetData(Type)

Devuelve un objeto de datos con un formato especificado por un objeto Type.Returns a data object in a format specified by a Type object.

GetDataPresent(String) GetDataPresent(String) GetDataPresent(String) GetDataPresent(String)

Determina si los datos están disponibles en un formato especificado por una cadena o se pueden convertir a él.Determines whether the data is available in, or can be converted to, a format specified by a string.

GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) GetDataPresent(String, Boolean)

Determina si los datos están disponibles en un formato especificado o se pueden convertir a él.Determines whether the data is available in, or can be converted to, a specified format. 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.A Boolean flag indicates whether to check if the data can be converted to the specified format if it is not available in that format.

GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type)

Determina si los datos están disponibles en un formato especificado por un objeto Type o se pueden convertir a él.Determines whether the data is available in, or can be converted to, a format specified by a Type object.

GetFileDropList() GetFileDropList() GetFileDropList() GetFileDropList()

Devuelve una colección de cadenas que contiene una lista de archivos colocados.Returns a string collection that contains a list of dropped files.

GetFormats() GetFormats() GetFormats() 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.Returns a list of formats in which the data in this data object is stored, or can be converted to.

GetFormats(Boolean) GetFormats(Boolean) GetFormats(Boolean) GetFormats(Boolean)

Devuelve una lista de formatos en los que se almacenan los datos de este objeto de datos.Returns a list of formats in which the data in this data object is stored. Una marca Boolean indica si también se incluyen los formatos a los que los datos se convertirán automáticamente.A Boolean flag indicates whether to also include formats that the data can be automatically converted to.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetImage() GetImage() GetImage() GetImage()

Devuelve un objeto BitmapSource que contiene los datos con el formato de Bitmap.Returns a BitmapSource object that contains data in the Bitmap format.

GetText() GetText() GetText() GetText()

Devuelve una cadena que contiene los datos de UnicodeText de este objeto de datos.Returns a string that contains the UnicodeText data in this data object.

GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat)

Devuelve una cadena que contiene los datos de texto del formato especificado en este objeto de datos.Returns a string that contains text data of the specified format in this data object.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Quita un controlador de eventos Copying de un objeto de dependencia especificado.Removes a Copying event handler from a specified dependency object.

RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler) RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler) RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler) RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)

Quita un controlador de eventos Pasting de un objeto de dependencia especificado.Removes a Pasting event handler from a specified dependency object.

RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Quita un controlador de eventos SettingData de un objeto de dependencia especificado.Removes a SettingData event handler from a specified dependency object.

SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[])

Almacena datos de audio (formato de datos de WaveAudio) en este objeto de datos.Stores audio data (WaveAudio data format) in this data object. Los datos de audio se especifican como matriz de bytes.The audio data is specified as a byte array.

SetAudio(Stream) SetAudio(Stream) SetAudio(Stream) SetAudio(Stream)

Almacena datos de audio (formato de datos de WaveAudio) en este objeto de datos.Stores audio data (WaveAudio data format) in this data object. Los datos de audio se especifican como secuencia.The audio data is specified as a stream.

SetData(Object) SetData(Object) SetData(Object) 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.Stores the specified data in this data object, automatically determining the data format from the source object type.

SetData(String, Object) SetData(String, Object) SetData(String, Object) SetData(String, Object)

Almacena los datos especificados en este objeto de datos, junto con uno o más formatos de datos especificados; una cadena especifica el formato de datos.Stores the specified data in this data object, along with one or more specified data formats; the data format is specified by a string.

SetData(String, Object, Boolean) SetData(String, Object, Boolean) SetData(String, Object, Boolean) SetData(String, Object, Boolean)

Almacena los datos especificados en este objeto de datos, junto con uno o más formatos de datos especificados.Stores the specified data in this data object, along with one or more specified data formats. 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.This overload includes a Boolean flag to indicate whether the data can be converted to another format on retrieval.

SetData(Type, Object) SetData(Type, Object) SetData(Type, Object) 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.Stores the specified data in this data object, along with one or more specified data formats; the data format is specified by a Type object.

SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection)

Almacena los datos de FileDrop en este objeto de datos.Stores FileDrop data in this data object. La lista de archivos colocada se especifica como colección de cadenas.The dropped file list is specified as a string collection.

SetImage(BitmapSource) SetImage(BitmapSource) SetImage(BitmapSource) SetImage(BitmapSource)

Almacena los datos de Bitmap en este objeto de datos.Stores Bitmap data in this data object. Los datos de la imagen se especifican como BitmapSource.The image data is specified as a BitmapSource.

SetText(String) SetText(String) SetText(String) SetText(String)

Almacena los datos de UnicodeText, especificados como cadena, en este objeto de datos.Stores UnicodeText data, specified as a string, in this data object.

SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat)

Almacena los datos de texto en este objeto de datos.Stores text data in this data object. El formato de los datos de texto que se van a almacenar se especifica con un miembro de TextDataFormat.The format of the text data to store is specified with a member of TextDataFormat.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Eventos adjuntos

Copying Copying Copying 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.Occurs when the associated dependency object has prepared appropriate data formats that represent the copy selection, added the copy selection formats to a DataObject, and is ready to either place the DataObject on the Clipboard or begin a drag-and-drop operation.

Pasting Pasting Pasting Pasting

Se produce cuando el objeto de dependencia asociado está listo para pegar los datos.Occurs when the associated dependency object is ready to paste data.

SettingData SettingData SettingData SettingData

Se produce cuando el objeto de dependencia asociado intenta agregar un nuevo formato de datos a DataObject.Occurs when the associated dependency object attempts to add a new data format to a DataObject.

Implementaciones de interfaz explícitas

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Crea una conexión entre un objeto de datos y un receptor de consulta.Creates a connection between a data object and an advisory sink. 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.This method is called by an object that supports an advisory sink and enables the advisory sink to be notified of changes in the object's data.

IDataObject.DUnadvise(Int32) IDataObject.DUnadvise(Int32) IDataObject.DUnadvise(Int32) IDataObject.DUnadvise(Int32)

Destruye una conexión de notificación que se había establecido previamente.Destroys a notification connection that had been previously established.

IDataObject.EnumDAdvise(IEnumSTATDATA) IDataObject.EnumDAdvise(IEnumSTATDATA) IDataObject.EnumDAdvise(IEnumSTATDATA) IDataObject.EnumDAdvise(IEnumSTATDATA)

Crea un objeto que se puede utilizar para enumerar las conexiones de consulta actuales.Creates an object that can be used to enumerate the current advisory connections.

IDataObject.EnumFormatEtc(DATADIR) IDataObject.EnumFormatEtc(DATADIR) IDataObject.EnumFormatEtc(DATADIR) IDataObject.EnumFormatEtc(DATADIR)

Crea un objeto para enumerar las estructuras FORMATETC para un objeto de datos.Creates an object for enumerating the FORMATETC structures for a data object. Estas estructuras se utilizan en llamadas a los métodos GetData(FORMATETC, STGMEDIUM) o SetData(FORMATETC, STGMEDIUM, Boolean).These structures are used in calls to GetData(FORMATETC, STGMEDIUM) or SetData(FORMATETC, STGMEDIUM, Boolean).

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Proporciona una estructura FORMATETC estándar que equivale lógicamente a una estructura más compleja.Provides a standard FORMATETC structure that is logically equivalent to a more complex structure. Utilice este método para determinar si dos estructuras FORMATETC diferentes devolverían los mismos datos, eliminando la necesidad de una representación duplicada.Use this method to determine whether two different FORMATETC structures would return the same data, removing the need for duplicate rendering.

IDataObject.GetData(FORMATETC, STGMEDIUM) IDataObject.GetData(FORMATETC, STGMEDIUM) IDataObject.GetData(FORMATETC, STGMEDIUM) IDataObject.GetData(FORMATETC, STGMEDIUM)

Obtiene los datos de un objeto de datos de origen.Obtains data from a source data object. 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.The GetData(FORMATETC, STGMEDIUM) method, which is called by a data consumer, renders the data described in the specified FORMATETC structure and transfers it through the specified STGMEDIUM structure. A continuación, el llamador asume la responsabilidad de liberar la estructura STGMEDIUM.The caller then assumes responsibility for releasing the STGMEDIUM structure.

IDataObject.GetDataHere(FORMATETC, STGMEDIUM) IDataObject.GetDataHere(FORMATETC, STGMEDIUM) IDataObject.GetDataHere(FORMATETC, STGMEDIUM) IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Obtiene los datos de un objeto de datos de origen.Obtains data from a source data object. 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.This method, which is called by a data consumer, differs from the GetData(FORMATETC, STGMEDIUM) method in that the caller must allocate and free the specified storage medium.

IDataObject.QueryGetData(FORMATETC) IDataObject.QueryGetData(FORMATETC) IDataObject.QueryGetData(FORMATETC) IDataObject.QueryGetData(FORMATETC)

Determina si el objeto de datos es capaz de representar los datos descritos en la estructura FORMATETC.Determines whether the data object is capable of rendering the data described in the FORMATETC structure. 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.Objects attempting a paste or drop operation can call this method before calling GetData(FORMATETC, STGMEDIUM) to get an indication of whether the operation may be successful.

IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean) IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean) IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean) IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)

Transfiere los datos al objeto que implementa este método.Transfers data to the object that implements this method. Este método es invocado por un objeto que contiene un origen de datos.This method is called by an object that contains a data source.

Se aplica a

Consulte también: